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About This Book 


When you hear that someone is a computer programmer, do you 
think of a wizard performing magic through a terminal keyboard? Do 
you think that only a scientist or a mathematician can unravel the 
complexities of computers? 


Programming is not so mysterious or complicated. Even if you are 
just learning about computers, you can be a programmer. 


This book introduces you to programming through the Restructured 
Extended Executor language, called REXX for short. Learning REXX 
doesn’t require a special skill. All you need is a terminal connected 
to the VM/IS system, and a willingness to learn. By learning the 
essentials of REXX, you can write programs to simplify your daily 
tasks. 


It’s easy—that’s the magic of REXX. 


Who Should Read This Book 


You should read this book if you are interested in learning a 
computer programming language. You do not need any previous 
programming experience. 
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Nhat This Book Contains 


This book contains three parts and an appendix. 


Part 1. Getting to Know REXX includes two chapters. The 
chapters contain information on what REXX programming is, 
what you need to get started, and some basic rules and 
concepts. 


Part 2. Writing Your Own Programs includes four chapters. 
The chapters explain how to write your first three programs, 
how to correct errors, how to work with arithmetic and true 
and false, and more. You can test yourself through some 
exercises. 


Part 3. Improving Your Skills includes two chapters. These 
chapters discuss writing more advanced programs, and 
where to find additional information on REXX. 


The Appendix contains the answers to all the exercises 
throughout the book. 


The back cover of this book has a wrap-around flap that you 


Can use as a bookmark. The flap contains a Summary of the 
REXX instructions used in this book. 
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Conventions Used In This Book 


Convention Meaning 


sample Information that you type is shown like this. 

sample Information that appears on the screen is shown like 
this. 

sample Words shown in bold italics appear in the glossary. 

sample Bold type is used for emphasis. 


Related Information 
As a user of VM and REXX, you may find the following books helpful: 


The VM/IS Learning to Use Your System: Getting Started book 
shows you how to use the VM/IS system. 


The Virtual Machine/System Product CMS Primer shows you how 
to create and edit files. 


The Virtual Machine/System Product System Product Interpreter 
User's Guide explains more about REXX through three reading 
levels: from beginner to advanced user. 


The Virtual Machine/System Product System Product Interpreter 
Reference contains reference material for the experienced 
programmer, particularly those who have used other 
programming languages. 
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The following information is illustrated in “VM/IS The Road to 
Discovery”: 


VM/Integrated System: 


Planning for Your System SC24-5337 

Installing Your System SC24-5341 

Managing Your System SC24-5338 

Reporting System Problems SC24-5339 

Learning to Use Your System: 
Getting Started SC24-5343 
Using FORTRAN and Advanced Graphics SC24-5344 
Using IBM BASIC and Pascal/VS SC24-5345 
Performing Office Tasks SC24-5346 
Using APL2 SC24-5347 
Using a Data Base SC24-5348 
Using Your /BM Personal Computer as a Display Station 
SC24-5349 
Communicating with Other VM Systems SC24-5350 
Error and Information Messages SC24-5351 
A Day in the Life of an Engineering Firm SC24-5352 


VM/System Product CMS Primer STO00-1992 

Writing Simple Programs with REXX SC24-5357 
Composing Documents with the Generalized Markup 
Language $544-3421 


Managing Your System: The Practice Diskette SV21-5273 
Managing Your System (videotape 3/4” U-Matic) SV26-1012 
Managing Your System (videotape 1/2” VHS) SV26-1013 
Introducing VM/IS (videotape 3/4” U-Matic) SV26-1016 
Introducing VM/IS (videotape 1/2” VHS) SV26-1017 


Writing Simple Programs with REXX 


> — i 
5 i 4 q 


Contents 


Part 1. Getting to Know REXX ............000008 1 
Chapter 1. introduction: g2.é6.<2i¢dei40c0se0e4edenesGebe dees ceed dt 3 
Wihiae Gan BREXX:DOIOr YOU? d5..canakes eda bowed He odd e ba dae 4 eee oS 4 
GeUING SIAC gong ces ea es eas OSs ee ee ewes Gee eee ee oot 5G eee 5 
Conversing with Your Computer ........... 0.0... cee ee eee 6 
RUNING YOURTIVSUIPFOOVEIMN, co:08 bo Vecenneedeenh ate do eeee tr Sha as 9 
WiaUS NOX? «2 2x44-6044 meta o eeu Yew s es oo ee oe 6 eee 6 ee Ke Eee 10 
Chapter 2. Learning a Few Rules ......... 2... 0 eee ee es 11 
COMMCINGS, 2ae4c2 405 nd pe Oe oe Gees hone bee Pe eee ERG ae art oe 12 
SUNS 6 ee wep os oa he oe eG Ere Peed bent ea eee se 13 
What's in. aREXA Program. ««.24¢¢s004 teee wee ev wed w hha ee ee eae O0 14 
WISTROUCTIONGS sce eeceun naa eo eos ie mee eee Bee ed toe hee eek hace? 15 

THe SAY WASIUCHON. sta 6 Gee wads 668 & We ee SOS eR RHODE SRE DE SO HE Ta 

The PULL and PARSE PULL Instructions ......................0.. 16 

MMe- EXIT STRUCTION 64 2 who each acess & og ok See Se setgih ws bee ee a OUR n 17 
ASSIGNINGIIS 226654454064 2e520 546 4456 be GEES be OSES A eures 18 
LADGIS Som tue 2.5 ose ae bon 65.0 ae Le ood 8 oS Oe we Rw Ae ee Sees oe aed 19 
COMimINtAnsS: g.06-o5 ee oh a as Or ee eee oe ee Pe wee 20 
Writing it MixX6d CaS@ .cied¢aduede dds dein obetusddetndowedlwawe« x 20 
USING QUOTES TOP SPACING <i¢44.6454. 9 28s deed dine euw Bad whee bbw ees 2] 
Adding Blank LinGS: sccesinede Fae dws bea a du ele bose doe Sha ee wo eS 22 
SUMMA Wen ae ae oom Ge ee oe ee RO Be eee 23 
Part 2. Writing Your Own Programs ............. 25 
Chapter 3. Writing Your First Program .............0 000 eee ees 27 
Pulling the Pieces TOGGING! 4444 so.0 dad oad oo eee wow eS be a ale ee ee 28 

WHUNGIN@: EXEC 24542644 each eee ioe od Bee oe Sb ed Ae ESES OO 28 

Creating the File for Your List .............0...0...000.....000000. 30 

Running the Program .......... 0.000. cc eee 31 
IAIN, ENGORS. 3 eae da ardncies bh Rae eas oe Be ee Oe ye ee eS 32 


Contents |x 


PXGIC\GCS a 4.n ye eects es A ioe 4 oe Eh Se a ee es he Bon ee oh eae es 34 


SUMOMIALY gaews oes oes Os oes coe ee Bete Ba ee eee ou ak Cie) 
Chapter 4. Working with Variables and Arithmetic ................... 37 
WS) aM AGS: on go moe & bo a ae ee a 8 es A ene Be Ee ee ow SE 38 
Choosing Names for VariableS ......... 0. cece eee 38 
ASSIONING VaIUCS 24. vow eh ba¥S- ond eee OSES BE Eee wee ee eee eek ee SZ 39 
Working with Arithmetic ..... 0.0000. 00 eee 42 
POGIWONS g2%4454 de 645 Ode OS Ae Ree OP ie ee ee eon 43 
SUD ACCU 2 cused care eae He ee ee bee ee gs Ree eo ee he we Bad oes 43 
WHUITISICAION 2y-s-a-dea tee oie oases e oad Eo oe ee ord oe cee ee 43 
DIVISION 2e2ts oo0.4o¢eed bao sed SHS CeO ta ee ar eee ee ees 44 
OOCTAIONS dau cance dbared Hare tae eee ds bee ee eee eee aha eee 46 
EValliating EXPYESSIONS « 2%.¢6044 44 ee 4a Reed 2945 GSH Ree ee SEAS BES 46 
Creating a Program ......... 00. ees 48 
Writing he POG ran «.20% o6es-8 66d h6 oa hee oe hasan eee ea deed 48 
RUNING INE PrOGIAW aac: ¢e-tb040 05640060850 b ode eee Dewees 50 
USING -GCOMMentS 2.445 x4 eke bheewas OO ERE EO een See ee os SS 51 
PXOICISES i6cn5e5 chee eee oe eee eee e bee eee es en eee Ge 52 
SOUITIUINAY: eho qv ae caer Gee Sets ACS ec See ts Wane @ arr gn od arena Saree & Sup we A eme wees 53 
Chapter 5. More about Expressions ............. 00 ee eee eee ees 55 
Ne NG ICCISIONS? 4:04 oto ot boa Ghee ee ee ee OG OS Se oe Bo ee eet 56 
THEI INSOCHOIN! 242944440 a ore oe od oe eee eB eee eS 57 
COU MISIMICHONMS % tn-d.g8 2h od a tees be OB le eee ee ee oe 58 
THE-ELSE KeEYWORd 2« 244ce% eh eoae sd Abou edd ede wee did s we dns oad 59 
ihe SELECT WiSirueuon: o¢¢iceev.d ctx ee eed bed 6 ed bw oe oS ae 61 
Whe NOP INSIMUGION 4.02 vo ee oe Kae Sete e ase Beek 64 we ae aie grass 64 
True and False OperatorS «6.0... . ae 65 
COMPAMSOUS woo eek cad oed bob oO EE Ee he wade Kee eee eae a 65 
EQWab So ac baeur'e aun bee eee ee ee ee ee une a ee Fe 67 
USING COMPANISONS: j4262ccnkew oe bee 8 PR eh OSES SSS KR OR EE 67 
Tite: Logical: NOT Operator 26 ede ee ew eaan doe SG Hed owe hoo Sg dee 68 
The Logical AND OpGraior 24.1 2444849444 404b8.4 owew deere eetaede es 68 
THe BOGiGal ORS AIOl ek esc sfc eva oie ire ds Barer ewiesaboliwesneineetavicebsamel %. 2-4-2044 69 
EXG(CISeS ¢ishadsdaxcdtand Oh eek kode 8 ob eter oe ae Habu ey Hee es 70 
SUMMIAIY 244 wd be eco at orb we ee oe ee oo we oe ae deebwee 71 
Chapter 6. Automating Repetitive Tasks ............ 0.0.0.0 eee ees 73 
USING LOOOS (aceon 364k ic bas ee eo oe oOo oe ee ee oe eee aes 74 
Repetitive LOOPS 2... eee £9 


Writing Simple Programs with REXX 


GOnditional (LOODS <.si¢usabseke ee eh oka oe OS boy oe Eee SHS Hoe es 78 


The DO WHILE and DO UNTIL Instructions ....................... 78 
Tite-LEAVEAINSHUMGHON: cots dice 56. Seb ak heel eee Bod eae @ OS Oe we 82 
The DO FOREVER Instruction ....... 0.0.00... 00 ec ee 83 
GeEUINGOULOLLGOPS «icc 5c¢tec4 bw ed hee bh Pe eb eha bbG aS os 84 
Papen WVORUS: 2.5 acne etn ae os ee eee Se ee Ae ee ae eee ee 85 
Creating Another Program ........0... 00. eee 86 
WHUNG ING PYOQlAM) «22640463 46-45% ¢ ade Ses bee ea eee me Hee eee ee eS 87 
RUNING The Program: +2 aceite S pha ace Fu ek be eee ee Gate R Gopal 91 
EXGICISCs 64444886644 685 ORS GRe EEE ORE HEH ES ee HOS oS edad os 92 
SUMINAIY, 46 can nee eee tas Heh ee oe we ee ea ae ee he eee eee 92 
Part 3. Improving Your Skills ...............005: 95 
Chapter 7. Using More Advanced Features ............... 000 cues 97 
SiG, FUIGHONS: | 6 dc onae 4 oes ewe eae oe ae 6 Vee A a ee ee 98 
BUIGIM:FUNCHONS ..co0648 2 coe shes ebedede bred Seaweed eesae wean 99 
UsereWrillen ‘FUNCIONS. ~<.cbh524 S<4 ek deo 6556654 Ree eet oe aR P hs 102 
WEIN SUOFOUNMCS: 4-4 a,2-0-9-7% 66-6 ee ww ae Oa a i Sas es 102 
Mie GALL IMSirenom g.4646<068.404 bebe kee be ued oe eee 104 
The ARG Instruction .. 0.0.0.0... 0.0 ee eee 106 
The RETURN INSWUGHOM: 4.45 2.:6-4.46 ead nas ee hee eo A we Ye ee eds 167 
Issuing Commands from an EXEC ............ 0.00.00 00 eee eee 107 
Working with Return Codes ........ 20.0.0. 0.02 ce 108 
EXGTGISGS 466¢-amae ores Riese eb ere eo ee be ee hee eee 110 
SUMMA Beene eo ede tad sa meee ota oe ed on oe hee as cee ee ee at Ta 
Chapter 8. Learning More About REXX ........... 2.00 cee eee eee 113 
Enhancing YOUr Programs «<4. «i. 64¢40~6é54euF04e vie dev db bee wee 114 
Modifying the NOTEPAD Program .............. 0.00000 114 
Modifying the CALC Program .......... 20... 0.0 cee ee 116 
Designing New Programs ...... 0... 0. cc ee eee 119 
The GUIME EXEC. 0c seed oe eX O16 bb hho be 64 eb ob oe oe orbs 120 
Finding More Information .......... 0.00.00... cee eee 123 
(ONGCIUSION. 2¢ we 6o 9 4as aa ee eaa e od Gat Bae ee eee ee ee 124 
Appendix. Answersto ExerciseS ........ 0.000 cece ee eee 125 
Chaplera ANSWers. 22. 2kc4oeen edd bao he eed Haw eke Ree ons BE SEe 125 


Contents xi 


xX 


Chavier SANSWES. 04; 5n44044405¢ ene ewe Peete Ee oe heed athe as 126 
Chapter 5 ANSWelS 64. oc545 0556004 bo Sh oD obo So OES ee) etd ek 127 
Cliapter OG ANSWEIS. oc 964 5454 odéue dowel oe PSR eke Eee EES EBRHEKE 127 
Cable) AGW 6 4<4cad eis deere core woe hy ore ee Cee keg oes 128 
GIOSSODV: 6 one eda ee Gea bas beedee eeeentoaes Coda eee ease wee 131 
GOK 5. baaa® Gidcm b wie as ace ee eae wr ed ee nde Be Se ee a 133 


Writing Simple Programs with REXX 


Contents  Xill 


T=) atialem (om .@alely nl =, 0,4 


: 


Part 1 Getting to Know REXX 


Writing Simple Programs with REXX 


i eee RETR. Fe Oh SPB 
Chapter 1. Introduction 


Learning a new programming language is like meeting someone for 
the first time: the first step is to get acquainted. In this chapter, you 
will be introduced to the Restructured Extended Executor 
language—REXX. Once you feel comfortable with REXX, you can 
begin to learn how to use it. 
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What Can REXX Do for You? 


Programs are lists of instructions to a computer. For example, 
someone has to write a program to tell the computer how to add and 
subtract numbers to produce your bank balance. Someone has to 
put codes and prices into the computer at the grocery store so the 
price appears when the code Is given. 


Programming has many uses in your everyday life. It can be fun and 
educational. It can make your work easier. 


Several languages are used to write programs. BASIC, a language 
widely used in home computing, has very few rules. However, 
writing an intricate program in BASIC usually involves writing a 
great many lines. Languages like PL/I, APL, and PASCAL have more 
rules but allow you to do more in fewer lines. 


REXX is a programming language that combines the simplicity of a 
language such as BASIC with the ability to write fewer lines as ina 
more powerful language. It is easy to learn because it uses familiar 
words and concepts. REXX allows you to do simple tasks, yet has 
the ability to handle complex tasks. 


A REXX program is processed by the System Product Interpreter. All 
you do to run a REXX program is type in the program’s name. 


As you become more experienced with REXX, you can include VM 
commands to enhance a program’s Capability. 
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Getting Started 


To begin using REXX, you should have access to a terminal 
connected to the VM/Integrated System (VM/IS). Once you are set 
up with a terminal, here’s what you need to do: 


Ask your system administrator for a system userid and password 
if you don’t have them. The system administrator also can 
answer any questions you may have about the computer. 


Familiarize yourself with VM. You need to know what a CMS file 
is, and how to create a file using an editor. If you need help, or 
want to brush up on your computer skills, see the CMS Primer or 
the Learning to Use Your System: Getting Started book. 


This book assumes you are NOT working with the menus and 
panels of the VM/IS Productivity Facility. If you are in the 
PRIMARY MENU or one of the panels, press the PF3 key to leave. 
You may have to press PF3 more than once. When you reach the 
CONFIRM END panel, follow the instructions to leave it, too. 


When you feel comfortable working with files, start the next 
section of this book, “Conversing with Your Computer.” 
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Conversing with Your Computer 
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Now let’s look at a REXX program. First, study the explanation of the 
sample program to see what the program contains. Later, you can 
try it out. 


The sample program is called the HELLO EXEC. HELLO is the 
filename, and EXEC is the filetype. REXX programs in this book 
have a filetype of EXEC. Sometimes people use the word “exec” 
interchangeably with the word “program.” The program looks like 
this: 


/*® AY InCrodu@ction to REXX */ 

say "Hello! 1. a@m REAX." 

say "What's your name?" 

pull who 
1f£ who = 


then 

say "Hello stranger" 
else 

say "Hello" who 
exit 


Figure 1. HELLO EXEC, a sample REXX program 
A brief description of each part of the sample program follows: 


/* An introduction to REXX */ 
This comment explains what the program is about. A comment 
starts with a /* and ends with a */. All REXX programs must start 
with a comment. 


say "Hello! | am REXX.” 

say “What’s your name?” 
These instructions display the words between the quotes on the 
screen. 
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pull who 
The PULL instruction reads the response entered from the 
keyboard and puts it into the computer’s memory. Who is the 
name of the place in memory where the user’s response is put. 
Any name can be used with the PULL instruction. 


ifwho = ”” 
The IF instruction tests a condition. The test in this example 
determines if who is empty. It is empty if the user types in a blank 
Space and presses the ENTER key, or just presses the ENTER 
key. 


then 
This direction executes the instruction that follows, if the tested 
condition is true. 


say “Hello stranger” 
This instruction displayS Hello stranger on the screen. 


else 
If the tested condition is not true, this direction executes the 
instruction that follows. 


say “Hello” who 
This instruction displays Hello on the screen, followed by 


whatever is In who. 


exit 
This instruction causes the program to stop at this point. 
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Here’s what happened when Mike tried the HELLO program: 


Ready; 

hello 

Hello! I am REXX. 
What's your name? 
Mike 

Hello MIKE 

Ready; 
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If Mike did not enter his name, but entered a blank space, this is 
what would have happened: 


Ready; 
hello 
Hello! I am REXX. 
What's your name? 


Hello stranger 
Ready; 
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Running Your First Program 


Not all REXX programs are this small, of course, but many are just 
as easy. Totry this program, first type on the command line: 


xedit hello exec 
and press the ENTER key. 


If you already have a file with the filename of HELLO and the filetype 
of EXEC, just use another name for the file (for example, HELLO1 
EXEC). Keep this in mind whenever you write a program or try one 
of the sample programs. 


This creates a file using the System Product Editor (XEDIT). You can 
also use an “x” for the XEDIT command. For example: 

x hello exec 

Next, type in the REXX program exactly as it appeared in Figure 1 
on page 6 and file it by typing on the terminal: 


file 
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To run the program, enter the name of your program, or use 


hello 


When the program requests it, you can enter your name, or you can 
press the ENTER key to see the other response. 


What’s Next? 
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If you tried the HELLO EXEC and it ran without any errors, you now 
have run your first program. Congratulations! If it didn’t work, 
compare your program with the sample program and see if you 
typed something incorrectly. 


The next chapter includes some rules for creating your own 
programs. To learn the concepts quickly, follow as we write some 
programs together. To reinforce what you have learned, try the 
exercises throughout the book. Don’t worry about making mistakes 
because you will be guided through the steps. 
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Chapter 2. Learning a Few Rules 


When you are trying a new sport or card game, it is usually easier to 
understand the plays if someone explains the rules. Learning isa 
step-by-step process. If you know the rules in the beginning, you can 
follow when the activity or action gets more complicated. We won’t 
show you any complicated moves here, just the easiest way to write 
programs that will execute correctly. 


The System Product Interpreter works on your REXX program, line 
by line, word by word, doing what you have written. This chapter 
includes a few rules to get you started. 
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Comments 


say "Hello!" /* This comment is on the same line as the instruction */ 
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From the first chapter, you may remember that all REXX programs 
must begin with a comment. 


A Comment is a group of words that tell what the program is for, 
what kind of input it can handle, and what kind of output it produces. 
Comments help you understand the program when you read it over 
later, perhaps to improve it. 


With VM/IS, there are three languages for writing EXECs: REXxX, 
EXEC 2, and CMS EXEC. The system distinguishes a REXX program 
from the other types because it contains a REXX comment on the 
first line. 


The symbols used for comments are: 
[* to mark the start of a comment 
*/ to mark the end of a comment. 


When the interpreter finds a /*, it stops interpreting; when it 
encounters a */, it begins interpreting again with the information 
following the symbol. The comment can be a few words or several 
lines, as in the following examples: 


/* This 1S a comment. */ 


Or, 


or, 


/* Comments can 
also occupy 
more than one line. */ 
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The /* */ is sufficient to start a program, but it is better to put a brief 
description of the program in the space. 


Strings 


A string is any group of characters inside single quotes or double 
quotes. Single and double quotes are interchangeable but the 
beginning and the ending must match. The interpreter stops 
interpreting when it sees a quote and looks for the matching quote. 
The characters inside the quotes remain as they are typed, with 
uppercase and lowercase letters. For example: 


"number ' 
“Live ana let Live,” 


are both strings. 


If you want to use a quotation mark or an apostrophe within a string, 
you should use different quotation marks around the whole string. 
For example: 


"Don't cross the bridge until you come to it." 


You can also use a pair of quotes (the same as those used to mark 
the string): 


say "Look out! ""He's"" here." 


This is interpreted by REXX as: 


Look out! “He’s” here. 
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In addition to comments, a REXX program can contain the following 
items: 


Instructions 
Assignments 
Labels 
Commands. 


It’s best to use one line for each item. If you want an item (for 
example, an instruction) to span more than one line, you must put a 
comma at the end of the line to indicate that the instruction continues 
on the next line. If you want to put more than one item on a line, you 
must use a semicolon to separate the items. 


The following program contains seven instructions. Can you find 
them? 


/*Find the items and cheer! */ 
say "Everybody cheer!" 
say es say MA say ign s say se uae: 


say "Who do we", 
"appreciate?" 
exit 


Figure 2. RAH EXEC, identifying items in a program 
Did you remember that exit is an instruction? 


As you read this book, you will encounter instructions, assignments, 
labels, and commands in more detail. In this chapter, they are 
explained briefly so you can see how they contribute to a REXX 
program. 
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Instructions 


An instruction tells the computer to do something: 


say "Time is of the essence" 


The computer displays Time is of the essence ON your screen. 
Instructions can contain one or more assignments, labels or 
commands and usually start on a new line. Some instructions that 
you will use often in your programs follow. 
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The SAY Instruction 
The example above uses the SAY instruction. The format is: 


Say expression 


The expression can be something you want displayed on the screen 
or something to be computed, such as an equation: 

say 4 + 3 "= seven" 

This will display 7 = sevenonthe screen. With the SAY 


instruction, anything not in quotes gets changed to uppercase. If you 
want something to appear “as is,” use quotes. 
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The PULL and PARSE PULL Instructions 


In a program, the usual sequence of instructions is to use SAY to ask 
a question and use PULL to receive the answer. The response typed 
in by the user is put in the computer’s memory. The following 
program would not work correctly if the PULL instruction came 
before you requested information with the SAY instruction. 


What do you think happens when the following program is run? 


j* Using the PULL Instruction *7 
say "Enter your name" 


pull name /* Puts response from user into memory */ 
say "Hello" name 
exit 


Figure 3. NAME EXEC puts a name in memory 


Let’s examine how this program works. You type name on the 
terminal, and Enter your name appears on the screen. You enter 
your name, and the program responds with a Hello to you. 


If you were Curious and tried the NAME program, you probably 
noticed that your name waS CHANGED TO UPPERCASE. If you want to 
keep the characters as you typed them, you can use the PARSE 
PULL instruction. 


Here’s an example using PARSE PULL. 
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/* Using the PARSE PULL Instruction */ 
say "Hello! Are you still there?" 


say "I forgot your name. What is it?" 
parse pull name 

Say name", are you going to the movies?" 
pull answer 

if answer = "YES" 

then 

say "Good. See you there!" 

exit 


Figure 4. CHITCHAT EXEC, how PULL and PARSE PULL work 


The PARSE PULL instruction reads everything from the keyboard “as 
is” in uppercase or lowercase. In this program, the name is 
repeated just as the user (you) typed it. However, “answer” is 
changed to uppercase characters because the PULL instruction was 


used. This ensures that if “yes,” “Yes,” or “YES” is typed, the same 
action is taken. 


In “Parsing Words” on page 85, you can find more information about 
what “PARSE” does. 


The EXIT Instruction 


By putting an EXIT in a program, you tell the program to end. The 
EXIT instruction should be used in a program that contains 
subroutines (Subroutines are explained in “Using Subroutines” on 
page 102), or if an error occurs. Although the EXIT instruction is 


optional in some programs, it is good programming practice to use it 
at the end of every program. 
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Assignments 


An assignment says that the string should be putin a special place 
in the computer’s memory. In the example: 


Home = '3600 Castle Way' 


the string 3600 Castle Way IS putin Home. Because Home can have 
different values (be reassigned to mean different things) in different 
parts of the program, it is called a variable. Variables will be 
discussed in “Using Variables” on page 38. 
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Labels 


Any word followed by a colon (with no space between the word and 
the colon) and not in quotes, is treated as a label. For example: 


MYNAME : 


A label marks the start of the subroutine. The following example 
shows one use of a label (called error) within a program: 


if problem = 'yes!' then call error 


error: 
say 'Problem in your data' 
exit 


Figure 5. This part of a program shows how labels identify subroutines 


For more information on labels, see “The CALL Instruction” on 
page 104. 
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Commands 


A command is a word, phrase, or abbreviation that tells the system 
to do something. In REXX, anything that is not a REXX instruction, 
assignment, or label is considered a command. For example, you 
can use the CMS commands of COPYFILE, QUERY, PRINT, or TYPE 
In your programs. 


The CMS command type may appear in a REXX program like this: 


/* Issuing commands in REXX */ 


type hello exec 
exit 


Figure 6. COMMAND EXEC, using commands in programs 


Although a variety of commands can be used in REXX, only CMS 
commands will be discussed in this book. In “Issuing Commands 
from an EXEC” on page 107, you can find more intormation on 
issuing commands from programs. 


Writing in Mixed Case 


You can use mixed case in REXX programs. Mixed case letters 
helps you distinguish instructions from variables, and helps you to 
find errors quickly. 
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Here’s what the HELLO program looks like using mixed case: 


f#*® AW Ineroduction Go REXX */ 
SAY "Hello! I am REXX." 
SAY "What's your name?" 
PULL who 
TF who = "" 
THEN 
SAY "Hello stranger" 
ELSE 
SAY "Hello" who 
EXIT 


Figure 7. New HELLO EXEC, using mixed case 


Using Quotes for Spacing 


If you put several spaces between words in your program, the 
interpreter keeps only one space between words. If you want more 
Space, you should use quotes, as in this program: 


/* Example of cases and spaces */ 
say Brevity 1s the soul of wit. /*One space between words*/ 


say "Brevity soul" 
say of" 
exit 


Figure 8. QUOTES EXEC, putting spaces between words 


Chapter 2 Learning a Few Rules” 21 


When run, the program looks like this on the screen: 


Ready; 

quotes 

BREVITY IS THE SOWG ‘OF WIT: 
Brevity is the soul 
OF WIT. 

Ready; 


Adding Blank Lines 


To leave a blank line between lines displayed in the output, you can 
use the SAY instruction with nothing following it. For example: 


/* Examples of cases and spaces */ 
say Brevity is the soul of wit. 
say /*This displays a blank line.*/ 


say "Brevity the soul" 
say of" 
exit 


Figure 9. QUOTES EXEC, adding blank lines 


It looks like this on the screen: 


Ready; 
quotes 
BREVITY IS THE SOUL OF WIT. 


Brevity is the soul 


OF WIT. 
Ready; 
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Summary 


You learned the following in this chapter: 


Comment Explains what the program will do. All 
REXX programs start with a comment. 


Identified by /* ... */. 
Instruction Tells the interpreter to do something. 


SAY Tells the interpreter to display words, or 15 
something computed, on the screen. 


Groups of characters within matching single 
or double quotes. 


PULL Puts an answer in memory. Response read 16 
from keyboard is put in uppercase. 


PARSE PULL 


Puts an answer in memory. Reads 
everything from the keyboard “as is” in 

uppercase or lowercase so the response 
appears as you typed the input. 


EXIT Tells the interpreter to leave the program. 
Assignment Gives a value to a variable. 


Label A name followed by acolon. Used in 19 
subroutines. 

Command Anything not identified as a REXX 20 
instruction, assignment or label. 

Mixed Case Not changed to uppercase. Use quotes 20 
around strings to keep upper- and 
lowercase letters and words. 

Quotes for Blanks To maintain blank spaces in what’s 21 
displayed when the program is run. 

Adding Blank Lines Use the SAY instruction with nothing 22 
following it. 
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Chapter 3. Writing Your First Program 


Do you remember the first time you drove a car? “Firsts” often make 
us feel uncertain. But writing your first program can be easier than 
you think. 
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Putting the Pieces Together 


Let’s try writing a simple program to give you a list of things to do 
today, and call it the NOTEPAD EXEC. You will receive hints along 
the way to help you write the program. 


The basic steps to writing a program are: 


1. Identify the problem to solve and translate it into a step-by-step 
procedure 


2. Write the REXX instructions to solve each step 

3. Run the program to see if the results meet the requirements 

4. Revise the program to correct errors. 

The steps outlined above will help you understand the process in 
writing a program. As a first hint, you can use two files for the 
NOTEPAD program: one for the EXEC and one to contain your list. 


Using a separate file for the list allows you to update the “things to 
do” every day without changing the EXEC. 


Writing the EXEC 
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To help you get started, here are the requirements for the NOTEPAD 
EXEC. The items are in the proper sequence for the program. 


The NOTEPAD EXEC should do the following: 
1. Identify and describe the REXX program 


2. Print a heading for your list of things to do 
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3. Print on the screen the file where you maintain the list 


Another hint: use the CMS command TYPE for this step. The 
TYPE command has this format: TYPE fn ft. For the filename 
(fn), name the file for your list anything you want, or use 
NOTEPAD. For filetype (ft), use LIST. 


4. Tell the interpreter to leave the program. 


Now, read each item and see If you can write an instruction or 
command for it. 


If you feel comfortable with the four lines you have written, type the 
EXEC and file it. Continue with the section, “Creating the File for 
Your List.” 


If you had trouble writing the program, continue with the following 
discussion of how to put it together. 


1. 


First, which of the following identifies a REXX program? Select 
one and write a statement for it. 


Choices: Assignment, String, Comment, Instruction 

Which instruction should you use to print a heading or message 
on the screen? Select one and write a statement for it. 
Choices: PULL, SAY, EXIT, PARSE PULL 

Next, how can you use the TYPE command to print the file with 


your list? Select a sequence. Insert your filename and the 
filetype “list” in the appropriate place. 
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Choices: 


say type fn ft 

pull fn ft type 
parse pull type ft fn 
type fn ft 


4. For the last step, which of the following instructions tells the 


interpreter to leave a program? Select one and write a statement 
1OF AC 


Choices: EXIT, END, LEAVE, STOP 


Now you can create a file for the EXEC. Enter: 


xedit notepad exec 


In input mode, type the program and file it. Congratulations! You 
have written your first REXX program. 


Creating the File for Your List 
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Now you need to create a file with things to do. The file for your list 
can contain anything you want. If you are not sure what to write, use 
the following: 

1. Answer mail. 


2. Call George about trip. 
3e Order books 


Create the file for your list. Use the name you have used in your 
NOTEPAD EXEC for the name of the file. 


xedit notepad list 


Enter your list or our sample list, and file it. Now you are ready to 
try running your first program. 
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Running the Program 


To run the NOTEPAD EXEC, enter: 


notepad 


Did you see a list of “things to do” on your screen? If not, take a 
look at our sample program and compare it to the one you wrote. 
Remember, there are many ways to write the same program. Your 
program may be correct, too! 


This is the program: 


/* A reminder of things to do. */ 
Say “Things to do Today." 


type notepad list 
exit 


Figure 10. NOTEPAD EXEC, listing things to do 


lf you ran our program, you would see this displayed on your 
terminal: 


Ready; 
notepad 
Things to do today: 


1. Answer mail. 
2. Call George about trip. 
3. Order book. 


Ready; 
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If you had trouble running your program, you may have typed 
something wrong which caused the interpreter to stop running the 
program. Most errors are simply syntax errors. (The syntax of a 
language is the way in which words are put together to form 
ohrases, instructions, or sentences. The rules discussed in this book 
are part of the syntax for interpreting REXX.) 
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Suppose you typed as the NOTEPAD EXEC: 


/* A reminder of things to do. */ 
say 'Things to do today:' 


type notepad list /*Types out your list 
exit 


Figure 11. NOTERR EXEC, finding the error 


The program has a syntax error: the missing */ to end the second 
comment. When you run the program, this appears on the screen: 


Ready ; 
riseterr 
Things to do today: 
3 +++ type notepad list /* Types out your listexit 


Error 6 running NOTERR EXEC, line 3: Unmatched "/*" or quote 
R(20006) ; 


This screen shows that the error occurred on line 3 of the program. 
The line that caused the error is printed on your screen: 


3 +++ type notepad list /*Types out your listexit 


The next line contains an error message and number: 

Error © running NOTERR EXEC; line 3% Unmatched "y*" or. quote 
You can find all REXX error numbers and messages in the VM/SP 
System Product Interpreter Reference if you need more information 


about the error. To correct the program, add the end */ to the 
comment. The line now looks like this: 


type notepad list yg? Types out your .list *7 
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A syntax error also occurs if you leave off a quote in an instruction. 
This program would cause a similar error: 


/* A program with a syntax error. */ 


say 'This program does absolutely nothing 
exit 


Figure 12. ERROR EXEC, missing an end quote 


To correct the SAY instruction, add the end quote or remove the first 
quote. 


You can find the answers to these exercises in the Appendix. 


1. Read the following program, MADAM EXEC, carefully. Ona 
piece of paper, write down what each word is (for example, an 
instruction), and what the interpreter will do with it. 


MADAM EXEC: 


/* A polite enguiry */ 
Jane = "Mrs. Doe" 


say "How" is jane ? 
exit 


Now, use XEDIT to create a file called MADAM EXEC and try out 
the program. Did everything happen as you expected it? If not, 
read Chapter 2 again and study the explanation in the Appendix. 
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2. The next program, TROUBLE EXEC, has an error in it. Type the 
program in and run it. Note the error number and write down 
what you think caused the error. 


TROUBLE EXEC: 


J* Fianoing errore *7 
say Look closely, and find the error here 
exit 


Summary 
You learned the following in this chapter: 
Follow the basic steps: Identify the 


problem; write the instructions; run the 
program; revise the program. 
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Chapter 4. Working with Variables and Arithmetic 


By now we hope you are feeling comfortable with REXX 
programming. In this chapter you will write another program that 
you Can use repeatedly. Before you write the program, you will 
learn how to use variables and arithmetic. You also will learn how 
to add comments throughout a program to describe how it works. 
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Using Variables 


A variable is a particular piece of data, used by a programina 
particular way, but whose value may vary. Within a program, each 
variable is known by its own unique name and ts always referred to 
by that name. 


Choosing Names for Variables 
When you choose a name for a variable, you must follow these rules: 
e The first character must be one of: 
ABC..Z@#$E!?_ 


Lowercase letters such as abc...z are also allowed. The 
interpreter changes them to uppercase. 


® The rest of the characters can be any of the above, plus these: 
0-9 


A period can also be used as a Special kind of variable. You will 
not learn how to use a period for variables in this book. 
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Assigning Values 


A variable’s value may vary, but not its name. When you name a 
variable and give it a value, it is an assignment . For example, any 
statement of the form: 


symbol = expression 
is an assignment statement. You are telling the interpreter to 


compute what the expression is and put the result into a variable 
called symbol. It is the same as Saying: 


“Let symbol be made equal to the result of expression.” 


The idea of assigning a value to a variable is the same as the 
difference between a post office box and the contents of the box. 

The box number does not change, but the contents of the box may be 
changed at any time. Another example of an assignment is: 


numl = 10 

One way to give the variable num1 a new value is by adding to the 
old value in the assignment: 

numl = numl + 3 

The PULL instruction can also be used to assign a variable. Do you 


remember the YOURNAME EXEC? The pull name says to give name 
whatever value the user types. 
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A special concept in REXX is that any variable which has not 
received a value will have the uppercase version of the variable as 
its initial value. For example, if you wrote in a program, 


list = 2 20 40 
say list 


you would see this on the screen: 

2 20° 40 

As you Can see, list receives the values it is assigned. But if you 
wrote: 


say list 
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you would see this: 
Lis? 


Let’s look at some ways of assigning values to variables. Hereisa 
simple program: 


/* AsSigning a value to a variable */ 
a = "abo? 
Say a 


bp = “Oder” 
say a b 
exit 


Figure 13. VARIABLE EXEC assigns values 


When you run the program, it looks like this: 


Ready; 
variable 
abc 

abc def 
Ready; 


Assigning values is easy, but you have to make sure a variable is not 
used unintentionally, as in this example: 


/* Unintentional interpretation of a variable */ 
a = 'abc' 


Say Today would be much nicer if it were a Friday 
exit 


Figure 14. VAROOPS EXEC, assigning a variable unintentionally 
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What do you think you will see when the program is run? It looks like 
this: 


Ready; 

varoops 

TODAY WOULD BE MUCH NICER IF IT WERE abc FRIDAY 
Ready; 


To avoid unintentionally substituting a variable for the word, all you 
have to do is put the sentence in quotes. 


/* No interpretation of a variable */ 
a = ‘abc' 


say 'Today would be much nicer if it were a Friday' 
exit 


Figure 15. New VAROOPS EXEC, assigning a variable correctly 
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Your REXX programs may need to include arithmetic operations of 
addition, subtraction, multiplication, and division. 


For example, you may want to assign a numeric value to two 
variables and add the variables together. 


Arithmetic operations are performed the usual way. You can use 
whole numbers and decimal fractions. A whole number is a number 
that has a zero (or no) decimal part (for example, 1 or 29). A decimal 
fraction contains a decimal point (for example, 1.5 or 0.5). 


Before you see how these four operations are handled in a program, 
we will explain what the operations look like and the symbols used. 
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These are just a few of the arithmetic operations used in REXX. The 
examples contain a blank space between numbers and operators so 
you can see the equations better, but the blank is optional. 


Addition 


The symbol to add numbers is the plus sign (+). An instruction to 
add two numbers is: 


say 4 + 2 


The answer you see on the screen is: 6. 


Subtraction 


The symbol to subtract numbers is the minus sign (-). An instruction 
to subtract two numbers is: 


Say 8 - 3 
The answer on the screen is: 5. 


Multiplication 


The symbol to multiply numbers is the asterisk (*). An instruction to 
multiply two numbers is: 


say 2 * 2 


The answer on the screen is: 4. 
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Division 

With division, there are several operators you can use, depending on 

whether or not you want the answer expressed as a whole number. 

For example: 

e To divide, the symbol is one slash (/). An instruction is: 
say 7 / 2 
The answer on the screen is 3.5. 

e To divide, and return just a remainder, the symbol is two slashes 
(//). An instruction Is: 
say 7 // 2 
The answer on the screen is 1. 

e To divide, and return only the whole number portion of an answer 
and no remainder, the symbol is the percent sign (%). An 
instruction Is: 
say 7 % 2 
The answer on the screen is: 3. 
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This sample program shows you how to perform four arithmetic 
operations on variables: 


/* Performing arithmetic on variables */ 
= 4 
Z 
at b 
say 'The result 
say 
c=a* b 


say 'The result 
say 


a- b 
say 'The result 
say 
c=a/b 
say 'The result 
exit 


Figure 16. MATH EXEC, using arithmetic 


On the screen, you see this: 


Ready; 

math 

The ,vesult ofr 42 + 2 1s 6 
The result of 4 * 2 is 8 
The result of 4 =- 2 is 2 


The result of 4 / 2 is 2 
Ready; 
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Operators 


The symbols used for arithmetic (+, -, *, /) are also called operators 
because they “operate” on the adjacent terms. In the following 
example, the operators act on the numbers (terms) 4 and 2: 


say 4 + 2 /* says ‘6! aa 
say 4 * 2 /* says '8' * S, 
say 4 / 2 /* says '2' le 


When you are attempting to do arithmetic from data you enter from 
the keyboard (in response to a prompt to enter numbers, for 
example), you should check that the data is valid. You can do this 
using the DATATYPE() function. This function and how to use other 
built-in functions is explained in “Using Functions” on page 98. 
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In REXX, expressions are normally evaluated left to right. An 
equation helps to illustrate this point. Until now, you have seen 
equations with only one operator and two terms, such as: 4 + 2. 
Suppose you had this equation: 


9-5+4 
The 9 - 5 would be computed first. The answer, 4, would be added to 
4 fora final value: 8. However, some operations are given priority 


over others. In general, the rules of algebra apply to equations. In 
this equation, the division is handled before the addition: 


10 + 8 / 2 


the value is: 14. 
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If you use parentheses in an equation, the interpreter evaluates 


what’s in the parentheses first. For example: 


7.2 


(10 + 8) 


The value is: 9. 
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sreating a Program 


For your second program, let’s put some of the rules you have 
learned into a program that you might use every day. You have just 
learned how REXX handles arithmetic. How about writing a program 
to add two numbers? Let’s call it the ADD EXEC. 


Keeping in mind the basic steps to writing a program, here is a list of 
what you need to do in this program: 


1. Identify and describe the REXX program 
2. Tell the user to enter numbers 


3. Read the numbers entered from the keyboard and put the 
numbers into the computer’s memory 


4. Add the two numbers and display the answer on the screen 


5. Tell the interpreter to leave the program. 


Vriting the Program 
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As you know, there are many ways to write programs to accomplish 
the same task. See if you can write instructions for each step. To 
make it easier, ask the user for each number separately, then add 
the numbers together. 


If you have written some instructions and want to try them, create a 
file for the ADD EXEC. Type your lines in and file it. Now run the 
program. Did it work? 


If your program worked, skip to the section on “Running the 
Program” to see how the sample program. If you had trouble writing 
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the program, continue with the following discussion of how to put the 
program together. 


ili 


First, what identifies a REXX program? If you thought of a 
comment, you were right. Take a minute to write a brief 
comment now. 


Next, you need to ask the user to enter numbers. What 
instruction displays a message on the screen? Did you think of 
the SAY instruction? Write an instruction to ask for the first 
number. 


If the number is entered, it needs to be put in the computer’s 
memory. Do you know the instruction that collects an answer 
and puts it in memory? If you guessed the PULL instruction, you 
are correct. Write your next instruction. 


Now, write an instruction to ask for a second number. 

Write another instruction to put the second number in memory. 
The next instruction is similar to one in the MATH program. In 
one statement, you can tell the interpreter to add the two values 
kept in memory, and display the sum on the screen. Hint: this is 


one instruction. It contains a string and the addition operation. 


Finally, write the instruction to finish the program. 


Now you can type the program and file it. Congratulations! You 
have written another REXX program. 
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Running the Program 
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To test the ADD EXEC, enter add and try some numbers. Were the 
numbers added together and the sum displayed on the screen? If 
not, try to correct your program by looking at the error messages. 


Take a look at the following sample program to see the ADD EXEC: 


/* This program adds two numbers */ 
say 'Enter the first number.' 
pul) num 


say 'Enter the second number. 
pull mumz 

say 'The sum of the two numbers is' numl + num2 
exit 


Figure 17. ADD EXEC, adds two numbers and displays the sum 


Here’s what happened when Mike tried it: 


Ready; 

add 

Enter @he first number. 

3 

Enter the second number. 

12 

The sum of the two numbers is 15 
Ready; 
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Using Comments 


When you write programs, keep in mind that other people may want 
to modify them. It’s a good idea to add comments to the instructions 
so that anyone can understand each step. If you don’t usea 
program for a while, you might be glad to have the reminder too. 
The ADD EXEC could have these comments: 


/* This program adds two numbers */ 

say ‘Enter the first number.' Enter a number 

pull numl Store number 

say ‘Enter the second number. ' Enter another number 


pull nunZ Store second number 

Add numbers and display 
say 'The sum of the two numbers is' numl + num2 
exit 


Figure 18. Comments in the ADD EXEC 


Longer programs may require a block of comments to explain a 
group of instructions. For example: 


/* Subroutine starts here to repeat shout three times. */ 
/* The first argument is displayed on the screen three */ 
/* times, with punctuation. a 


In general, tf you explain your program well, everyone will 
understand it. 
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Exercises 


You can find the answer to these exercises in the Appendix. 


1. Which of the following could be used as the name of a REXX 
variable? 


a. Scroll 
b. KP 
c. old_world 
d. 2B 
e. #1 
2. The following program, ASSIGN EXEC, assigns a value to a 
variable. However, something is missing in the program. Write 


down what you think the error is and how you would correct it. 


ASSIGN EXEC: 


/* This program has something missing! */ 


say input 
exit 


Now, type the program in with your correction. Does it work? 
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3. What will this program display on the screen? 


FAMILY EXEC 


/* Simple arithmetic using variables */ 


" patmatkids " people in this family" 


Summary 


You learned the following in this chapter: 


/, //, % operators 


Arithmetic Follow the rules of algebra. 
Expressions 
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Chapter 5. More about Expressions 


So far you have seen several REXX programs and you have created 
two of your own programs. You know how to communicate with the 
computer in simple terms, just as you might learn to talk in brief 
sentences to someone who speaks another language. 


In this chapter, you will see how to take advantage of some features 
of REXX that can help you write more involved programs. You will 
learn how to have a program make decisions by testing a value with 
the IF instruction. You will see how to compare values and 
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determine if an expression is true or false. All these features help 
you communicate more fluently with REXX. 


Making Decisions 


56 


All the programs you have seen or written so far have executed 
“sequentially.” This means that each instruction is processed in the 
order it is written, beginning with the first line of the program. An 
important feature of programming is that you can control the order in 
which statements are run. 


ee \ 
SEZ 


Two instructions that let you make decisions in your programs are 
the IF and SELECT Instructions. The IF instruction lets you control 
whether the next instruction should be run or skipped. The SELECT 
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instruction lets you choose one instruction to run from a group of 
instructions. 


The IF Instruction 


The IF instruction is used with a THEN keyword to make a decision. 
The interpreter executes the instruction if the expression is true. For 
example: 


if answer = "YES" 
then 
say "OKI" 


In the above example, the SAY instruction is run only if answer has 
the value of YES. 


Notice, too, that the instructions above are indented. Use 
indentation, especially for longer programs, because it groups 
related lines and makes your program easier to read. The number 
of spaces to indent the instructions is up to you. 


The following diagram illustrates making a decision with the IF-THEN 
format. 
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expression 


expression 


DO 
instruction\ 

instruction2 
instruction3 


instruction 


END 
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Grouping Instructions 


To tell the interpreter to execute a list of instructions following the 
THEN keyword, use: 


DO 
InNStruct1o6n | 
instruction2 
INSULUCT AON 
END 
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The DO instruction and its END keyword tell the interpreter to treat 
any enclosed instructions as a single instruction. 
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The ELSE Keyword 


To tell the interpreter to select from one of two possible instructions, 
use: 


if expression 


then instructionl 
eles anstructi1onZ 
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You could include the IF-THEN-ELSE format in a program like this: 


if answer = 'YES' 
then say ‘OK!' 
else say ‘Why not?' 


Try this example to see how it works: 


f* Using IF-THEN=ELSE */ 
say "Do you like me?" 
pull answer 

if answer = "YES" 

then 


say "I like you too." 
else 


say "I don't like you either." 
exit 


Figure 19. LIKEME EXEC, choosing between two instructions 


When Mike tried the program, he saw: 


Ready; 

likeme 

Do you like me? 
yes 

I like you too. 
Ready; 
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The SELECT Instruction 


The SELECT Instruction tells the interpreter to select one of a 
number of instructions. It is used only with the keywords WHEN, 
THEN, END and sometimes, OTHERWISE. The END statement marks 
the end of every SELECT group. 


The SELECT instruction looks like this: 


Shue T 
WHEN expressionl 
THEN instructionl 
WHEN expression2 
THEN anstruction?2 
WHEN expression3 
THEN. instruct 10n3 


OTHERWISE 
Instruction 
Instruction 


IMStruct1on 
END 


Note that an IF-THEN instruction cannot be used with a SELECT 
instruction, unless it follows a WHEN or OTHERWISE instruction. 
You can read this format as follows: 


e If expressionl is true, instructionl is run. After this, 
processing continues with the instruction following the END. The 
END keyword signals the end of the SELECT instruction. 


e If expression! is false, expression2 is tested. Then, if 
expression2 is true, instruction2 is run and processing 
continues with the instruction following the END. 


e lf, and only if, all of expressionl, expression2, etc., are false, 


then processing continues with the instruction following the 
OTHERWISE. 
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This diagram shows the SELECT instruction: 


SELECT 
THEN 
WHEN 
True ae 
| instructiont 


THEN 


WHEN 7 
WHEN 


instruction(s) 


OTHERWISE 


END 


A DO-END could be included inside a SELECT instruction like this: 


hey nl, Oa 
WHEN expressionl THEN 
DO 
jieesaeu ave. eaike rem. 
LNStCLruUee Ione 
INnseruclion3 
END 
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You can use the SELECT instruction when you are looking at one 
variable that can have several different values associated with it. 
With each different value, you can set a different condition. 


How does the SELECT instruction fit a program you might use? 
Suppose you wanted a reminder of weekday activities. For the 
variable “day”, you can have a value of Monday through Friday. 
Depending on the day cf the week (the value of the variable), you 
can list a different activity (instruction). You could use a program 
like this: 


/* Selecting weekday activities */ 
say 'What day is it today?' 
pull day 
select 
when day = 'MONDAY' 
then 
say 'Exercise class today' 
when day = 'TUESDAY' 
then 
say 'Do the laundry' 
when day = 'WEDNESDAY' 


then 


say ‘Exercise class again' 
when day = 'THURSDAY' 
then 
say 'Clean the house' 
when day = 'FRIDAY' 
Chen 
say 'Happy Hour!' 
otherwise 
say "It's the weekend!" 
end 
exit 


Figure 20. SELECT EXEC, choosing from several instructions 


Mike tried this program too. Here’s his reminder: 
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Ready; 

select 

What day is it today? 
Thursday 

Clean the house 
Ready; 


The NOP Instruction 


In a program, a THEN or ELSE keyword must be followed by an 
instruction. If you are using an instruction Such as SELECT, and you 
intend that nothing should happen for one expression, you can use 
the NOP (No Operation) instruction. 


This example uses the previous SELECT program: 


/* Selecting weekday activities */ 
say 'What day is it today?' 


pull day 
Select 
when day = 'MONDAY' 
then 
say ‘Exercise class today' 
when day = 'TUESDAY' 
then nop /* Nothing happens here */ 
when day = 'WEDNESDAY' 
then 
say 'Exercise class again' 
when day = 'THURSDAY' 
then 
say 'Clean the house! 
when day = 'FRIDAY' 
then 
say ‘Happy Hour!' 
otherwise 
say "It's the weekend!" 
end 
exit 


gure 21. SELECT EXEC with NOP 


Writing Simple Programs with REXX 


. 


a 


7 


Bea an OB 


. 


Suet B 


Bean s 


SS @ 


a 8 B 


. 


True and False Operators 


Determining if an expression is true or false is useful in your 
programs. lf an expression is true, the computed result is “1”. If an 
expression is false, the computed result is “0”. The following 
sections show several ways to check for true or false. 


Comparisons 


Some operators you can use for comparisons are: 


> Greater than 
< Less than 
Equal to 


Comparisons can be made with numbers, or they can be character 
by character. Some numeric comparisons are: 


The value of 5 > 3is1 This result is true. 

The value of 2.0 = 002is1 This result is true. 

The value of 332 < 299isQ This result is false. 

If the terms being compared are not numbers, the interpreter 


compares characters. For example, the two words (strings) 
“airmail” and “airplane” are compared as follows: 
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pad 


LT laltfelmpoy ite | 
Pr om] renee 
ae SS m<p so. airmail < airplane 
a Ee et aL P| | 


If this seems confusing, think of the REXX interpreter comparing the 
words like this: 


e Leading and trailing blanks are ignored. These are the blank 
spaces before or after the word. 


e The shorter word (airmail) is padded on the right with blanks. 


e The words are compared from left to right, character by 
character. 


e Ifthe strings are not equal, the first pair of characters that do not 
match are used to determine the result. 


A character is less than another character according to this 
sequence of lowest to highest value: 


Lowest | ———___ se «SHighest 
blank 


special characters (for example: &, !, $, %, ?, #, @) 
a Z 
A Z 
0 g 
Highest 


When “airmail” and “airplane” are compared, the first character that 
is different is the “m” of airmail and the “p” of airplane. The “m” is 
less than the “p,” so “airmail” is less than “airplane.” 
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Equal 
An equal sign (=) can have two meanings in REXX, depending on its 
position. For example: 
amount = 5 /* This 1S an assignment */ 
says the variable amount gets the value of 5, as discussed in 
“Assigning Values” on page 39. If an equal sign is in a statement 


other than as an assignment, it means the statement is a 
comparison. For example: 


Say amount = 5 /* This 1S a comparison */ 


compares the value of amount with 5. If they are the same, a “1” is 
displayed, otherwise, a “OQ” is displayed. 


Using Comparisons 


This program uses comparisons and an equal expression to 
determine if numeric expressions are true or false. 


/* Determining if expression is true or false */ 
/* 1 is true; O is false Le 


result of' a 


e result of' 


b 
b 
b 


Figure 22. TF EXEC, checking for true or false 
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When you run the program, it looks like this: 


Ready; 

cr 

The result of 4 > 2is 1 
The result of 4 < 2 is 0 
The result of 4 = 2 is 0 


Ready; 


The Logical NOT Operator 


Logical operators can only return the values of 1 or 0. The NOT 
operator (—) in front of a term reverses its value from true to false, 
or from false to true. 


Say 1 O /* says '1' * ff 
Say 11 /* says 'O' ae 
say 1 (4 = 4) /* says 'O' * 
say 1 2 /* gives a syntax error */ 


The Logical AND Operator 


The AND operator (&) between two terms gives a value of true only if 
both terms are true. 


say (3 = 3) & (5 = 5) /* says '1' ae 
say (3 = 4) & (5 = 5) /* says '0! x / 
say (3 = 3) & (4 = 5) /* says '0! Ff 
say (3 = 4) & (4 = 5) /* says '0' x / 
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/* Using the AND (&) Operator 


/* QO is false; 1 is true 


b) & (b > 
result .of 
b) & (b < 
result of 


Figure 23. AND EXEC, checking for two true statements 


On the screen, the program looks like this: 


R; 

and 

The result of (a > b) & 
The result of (a > b) & 
Re 


The Logical OR Operator 


The OR operator (|) between two terms gives a value true, unless 
both terms are false. 


say (3 = 3) | (5 = 5) /* says '1' * 7 
say (3 = 4) | (5 = 5) /* says ‘1! ae 
say (3 = 3) | (4 = 5) /* says ‘1! ar 
say (3 = 4) | (4 = 5) /* says ‘0! a 
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The following program shows the OR operator: 


/* Using the OR (|) Operator 
/* O is false; 1 is true 


by |. to 2 
result of 
iy ||, Ub. 
result of 


Figure 24. OR EXEC, statement true unless both values false 


On the screen, the program looks like this: 


Ready; 

or 

The result of la > b) & (6 > c) is 1 
The result of (a > b) & 
Ready; 
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Exercises 


You can find the answer to these exercises in the appendix. 


1. Read the following program, MEASURES EXEC. Write down what 
you think will appear on the screen when the program is run. 
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Summary 


MEASURES EXEC: 


f* Comparing numbers */ 
dozen = 12 

score = 20 

Say score = dozen + 8 


say 

/* Using the AND operator */ 
say dozen = 12 & score = 21 
exit 


2. What is the value of each of the following expressions? 


“5” > “five” 

“Kilogram” > “kilogram” 
“a” > He 

“gh > 19” 

“Qa” > “g” 

a 


You learned the following in this chapter: 


Used with THEN. Checks if the expression 
is true. Makes a decision about a single 
instruction. 


Identifies the instruction to be executed If 

the expression is true. 

ELSE Used with the IF instruction. Tells the 
interpreter to select one of two instructions. 
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DO-END Indicates that a group of instructions should 

be executed. 

SELEGT Tells the interpreter to select one of a 
number of instructions. 

WHEN Used with SELECT. Identifies an expression 
to be tested. 

OTHERWISE Used with SELECT. Indicates the 
instructions to be executed if expressions 
tested are false. 


Used with an instruction when you want 64 
nothing to happen for one expression. 
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Chapter 6. Automating Repetitive Tasks 


Do you often do one task over and over again? 


Within a program, you can automatically repeat a task by using 
loops. Through loops, you can keep adding or subtracting numbers 
until you want to stop. You can define how many times you want a 
program to handle an operation. 


In this chapter, you will learn how to use some simple loops. And, 
you will write your third program. 
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Jsing Loops 


If you want to repeat several instructions in a program, you can use 
a loop. Loops are often used in programming because they 
condense many lines of instructions into a group that can be 
executed more than once. Loops make your programs more 
concise. And, with a loop, you can keep asking for input from a user 
until the correct answer is given. 


The two types of loops you may find useful are repetitive loops and 
conditional loops. Loops begin with a DO statement and end with 
the END statement. 


Simple repetitive |oops can be executed a number of times. You can 
specify the number of repetitions for the loop, or use a variable that 
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has a changing value. Conditional loops are executed when a true 
or false condition ts met. 


Repetitive Loops 
To repeat a loop a fixed number of times you can use the following 
simple loop: 
DO num 
Instruction 
InsrructionZ 


InNSt~LVuce tons 


END 


The num is a whole number, which is the number of times the loop is 
to be executed. 


Here is an example of a simple repetitive loop: 


/* A simple loop */ 
do 5 


say ‘Ho' 
end 
exit 


Figure 25. LOOP EXEC, an example of a simple loop 
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When you run the LOOP EXEC, you will see this on your screen: 


Ready; 
loop 
Ho 

Ho 

Ho 

Ho 

Ho 
Ready ; 


Another format is: 


DO 3 = 1 “Eo 10 


This format numbers each pass through the loop so you can use it as 
a variable. The value of I is changed (increased by 1) each time you 
pass through the loop. The “1” (or some number) gives the value 
you want the variable to have the first time through the loop. The 
“10” (or some number) gives the value you want the variable to have 
the last time through the loop. 


An example is: 


/*® #nocCNer Loop: *y 
sum 
Do I = 1 to 10 
say 'Enter value' I 


pull value 

sum = sum + value 
end 
say 'The total is' sum 
exit 


Figure 26. NEWLOOP EXEC, an example of another loop 
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Here’s the results when Mike tried this program: 


Ready; 


newloop 


Enter 
Z 
Encer 
4, 
Enter 
6 
Enter 


The total is 110 
Ready; 


value 


value 


value 


value 


value 


value 


value 


value 


value 


value 


9 


10 


When a loop ends, the program continues with the next instruction 
following the end of the loop, identified by the END keyword. 
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Conditional Loops 


Conditional loops are executed as long as a condition is met. The 
following sections describe some instructions used for conditional 
loops. 
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The DO WHILE and DO UNTIL Instructions 


The DO WHILE and DO UNTIL instructions are run “while” or “until” 
some condition is met. A DO WHILE loop is: 


DO WHILE expression 
instruction! 
instructicon2 
instruction3 

END 


With the DO WHILE instruction, the program evaluates if the 
expression is true before processing the instructions that follow. If 
the expression is true, the instructions are executed. If the 
expression Is false, the loop ends and moves to the instruction 
following the END instruction. The DO WHILE instruction tests for a 
true or false condition at the top of the loop. 
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This diagram shows the DO WHILE instruction: 


DO WHILE 


expression 


instruction’ 
instruction2 
instruction3 


END 


A program using a DO WHILE loop is: 


/* Using a DO WHILE loop */ 

say 'Enter the amount of money available' 
pull salary 

Spent = 0 

do while spent < salary 


say 'Type in cost of item' 
pull cost 
Spent = Spent. + Cost 

end 

say ‘Empty pockets.' 

exit 


Figure 27. DOWHILE EXEC tests for true or false at top of loop 
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After running the DOWHILE program, It looks like this: 


Ready; 

dowhile 

Enter the amount of money available 
100 

Type in cost of item 
a7 

Type in cost of item 
24 

Type in cost of item 
33 

Empty pockets. 
Ready; 


A DO UNTIL instruction differs from the DO WHILE because it 
processes the body of instructions first, then evaluates the 
expression. lf the expression is false, the instructions are repeated 
(a loop). If the expression is true, the program ends or moves to the 
next step outside the loop. 


The DO UNTIL instruction tests at the bottom of the loop and, 
therefore, the instructions within the DO loop are executed at least 
once. 


A DO UNTIL loop looks Iike this: 

DO UNTIL expression 
instruction 
imstyvucteio0nZ 


InSite i0cHnS 


END 
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This diagram shows the DO UNTIL instruction: 


DO UNTIL 


instruction1 
instruction2 
instruction3 


expression 


END 


The DOWHILE program can be changed to process a DO UNTIL loop 
like this: 


/* Using a DO UNTIL loop */ 

say 'Enter the amount of money available' 

pull salary 

spent = 10 f/* Seuss. Soper. tO 2a walue of 10 */ 
do until spent > salary 


say 'Type in cost of item' 
pull. cost 
SCENT = spent «+ Cos” 
end 
say 'Empty pockets. 
exit 


Figure 28. DOUNTIL EXEC tests for true or false at bottom of loop 
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It looks like this on your screen: 


Ready; 

dountil 

Enter the amount of money available 
a a 

Type in cost of item 

37 

Type in cost of item 

14 

Empty pockets. 

Ready; 


The LEAVE Instruction 


In the above example, you may want to end the loop before the 
ending conditions are met (before you run out of money). You can 
accomplish this with the LEAVE instruction. This instruction ends the 
loop and and continues processing with the instruction following the 
END. 


7/* Using the LEAVE instruction in a loop */ 
say 'Enter the amount of money available' 
pull salary 
spent = 10 /* Sets spent to a value of 10 */ 
do until spent > salary 
say 'Type in cost of item or END to guit' 
pull cost 


if cost = 'END'! 
then 
leave 
SDenL. = Spent +f COST 
end 
say ‘Empty pockets. 
exit 


Figure 29. LEAVE EXEC causes the interpreter to end the loop 
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The DO FOREVER Instruction 


There may be situations when you don’t know how many times to 
repeat a loop. For example, you may want a user to enter specific 
numeric data (numbers to add together), and you want the loop to 
perform the calculation until the user says to quit. For this program, 
you can use the DO FOREVER instruction with the LEAVE instruction. 


A simple use of aDO FOREVER loop is: 


yj* Using @ DO. FOREVER loop to. add numbers */ 
sum = 0 
do. forever 
say ‘Enter number or END to quit' 
pull value 
if value = 'END' 
then 
leave /* Program quits when user enters 
sum = sum + value 
end 
say 'The sum is' sum 
exit 


Figure 30. FOREVER EXEC ends when the user quits 


'end' 


a 
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Getting Out of Loops 


CN 


a alle: 
; *. 

“« 

‘ 


AN 


To stop most programs, you can enter the command: 


seal 


However, if you tried a program like the one below, the HI command 
will not work. 


84 Writing Simple Programs with REXX 


= 


/* Guess the secret password ! */ 
do until answer = "I guit!" 
say "What 1S your answer?" 
pull answer 
end 
exit 


Figure 31. SECRET EXEC, a program that may never end 


If you were not familiar with the program, you would not know the 
correct response to end it. Typing HI will not stop the program. The 
HI Just gets compared with I quit!, and because they are not 
equal, entering HI will never work. 


You can recognize this situation because, whatever you do, the 
words VM READ continue to appear in the bottom right hand corner of 
your screen. If you don’t know the answer, the simplest way out is to 
enter: 


#cp ipl -cms 


For more information on this command, see the VM/SP CMS Primer. 
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Parsing Words 


In “The PULL and PARSE PULL Instructions” on page 16 you 
learned that the PULL instruction collects a response and puts it in 
the computer’s memory as a variable. PULL can also be used to 
fetch several words and put each word into a different variable. In 
REXX, this is called parsing. The variable names used in the next 
example are: FIRST, SECOND, THIRD, and REST. 


say 'Please enter three or more words:' 
pull first second third rest 
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Suppose you entered this as your response: 


garbage in garbage out 


When you pressed the ENTER key, the program would continue. 
However, the variables would be assigned as follows: 


The variable FIRST is given the value “GARBAGE” 
The variable SECOND is given the value “IN” 

The variable THIRD is given the value “GARBAGE” 
The variable REST is given the value “ OUT” 


In general, each variable gets a word, without blanks, and the last 
variable gets the rest of the input, if any, with blanks. If there are 
more variables than words, the extra variables are assigned the null, 
or empty, value. 
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Creating Another Program 
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The third program you will create combines several concepts from 
this part of the book. It’s something you can use every day: a 
simple desk calculator. The CALC EXEC will handle the four 
arithmetic operations of addition, subtraction, multiplication, and 
division. Let’s also incorporate a loop in the program so you can 
enter calculations without restarting the program. 


Think about the requirements for this program. Cover up the next 
section with a piece of paper, and try writing a list of what the 
program should do line by line. 


Did you have trouble writing a list? Now look at the requirements 
below and see if you understand them. 


Writing Simple Programs with REXX 


In the program, you will: 

1. Identify and describe the program. 

2. Tell the user to enter numbers and operators (like an equation). 
3. Put the numbers and operators in the computer’s memory. 


4. Tell the interpreter to select one of the arithmetic operations to 
perform and process the arithmetic operator. 


5. Display the answer on the screen. 


6. Allow the user to keep entering calculations without starting the 
program again, or allow the user to end the program. 


Writing the Program 


You probably know several instructions to write for this program. 
Write down as many statements as you can for the steps. If you can’t 
complete an entire instruction or statement, write as much as you 
can. Think about the program from beginning to end, and the proper 
sequence of the steps. 


If you think you have a complete program, type it in and run it. If you 
need more explanation, continue with the following section. 


1. Write a statement to identify the REXX program. You should feel 
confident in completing this required first step. 


2. The next step requires asking for input. With a piece of paper, 
cover the paragraphs that follow so you can think through this 
step before you see our suggestions. Remember, the user 
should enter numbers and arithmetic operators. Write 
instructions to tell users to enter numbers and an operator, what 
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form they should use, and what symbols represent the operators. 
These instructions should be informative so the user knows how 
to use the program. 


Hint: Use a block of SAY instructions to display all the 
information on the screen. 


Write down your ideas. When you are finished, look at our 
suggestions below. If your instructions are somewhat different, 
remember, they may work too! 


/* This program is your desk calculator. */ 
say 'This program acts as a desk calculator. 
say ‘Enter calculations in the form of:' 

say ‘number operation number' 

say ‘where operation is the symbol: + - * / 
say 'for ADD, SUBTRACT, MULTIPLY, or DIVIDE' 
say 

say 'Enter your calculation (or press ENTER to quit)' 


Now the equation (numbers and an operator) needs to be put in 
the computer’s memory. Write an instruction to do this. 


Next, if valid numbers and an operator are given, you want the 
interpreter to “select” the appropriate instruction to perform. 
What instruction would you use? 


Hint: Write a separate statement for each operation. Include an 
instruction to display the answer on the screen. Look back at the 
MATH EXEC and the ADD EXEC for ideas. 


To keep entering calculations without having the program stop 
requires repetition of a group of instructions. If you thought of 
using a loop, you’re right! Write down the instruction for a DO 
FOREVER loop. 


Suppose the user doesn’t enter a number. Let’s provide a way of 
exiting the program if no numbers are given. 
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Hint: You can use the IF instruction with a THEN keyword. 


7. You are almost finished. Write the instruction to end the 
program. 


You now have worked through the steps for the CALC EXEC. It’s 
important, however, to put the instructions in the proper sequence. 
Think about the placement of the loop. Remember to end the loop 
and the SELECT instruction. When you have finished putting the 
CALC EXEC together, type the program in and file it. 
Congratulations again on writing a program! 
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When the instructions discussed above are put together, the program 
looks like this: 


/* This program is your desk calculator. #*/ 
say 'This program acts as a desk calculator. 
say 'Enter calculations in the form of:' 

say ‘number operation number' 


say 'where operation is the symbol: + - * /! 
say 'for ADD, SUBTRACT, MULTIPLY, or DIVIDE' 
say 


do forever 
say 'Enter your calculation (or press ENTER to quit)' 
pull numl op num2 /* Gets numbers and operator ca 
if numl = '''! /* If user presses ENTER key or space */ 
then /* program ends. Le 
leave 
seleccr 
when op = '#' 
then 
say numl op num2 ‘'is' numl + num2 
when op = !-' 
then 
Say numl op num2 ‘is 
when op = '*! 
then 
say numl op num2 
when op = !'/' 
then 
say numl op num2 '‘'is 
otherwise 
Say numl op num2 “1s not a valad caltulation, Try again!" 
end 
end 
exit 


numl - num2 


numl * num2 


numl / num2 


Figure 32. CALC EXEC uses the DO FOREVER and SELECT instructions 
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Running the Program 


To test the CALC program, enter calc on the command line. Mike 
tried some numbers and here’s the result: 


Ready; 

cale 

This program acts as a desk calculator. 
Enter calculations in the form of: 
number operation number 

where operation is the symbol: + - * 
for ADD, SUBTRACT, MULTIPLY, or DIVIDE 


Enter your calculation (or press ENTER to quit) 
56 / 93 

pe ¢ @ Bee 6.22222222 

Enter your calculation (or press ENTER to quit) 
2 ere 

12 * 12 is 144 

Enter your calculation (or press ENTER to quit) 
zy - 6 

7 - 6 dell 

Enter your calculation (or press ENTER to quit) 


Ready; 
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Exercises 


You can find the answer to this exercise in the appendix. 
Write a program to say the days of the week repeatedly. Use: 


Sunday 
Monday 
Tuesday 
Wednesday 
Thursday 
Friday 
Saturday 
Sunday 
Monday 


To stop the program, use the CMS command HI (Halt Interpretation). 


summary 
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You learned the following in this chapter: 


DO num Loop Repeats loop a fixed number of times. 


DO | = 1 to 10 Loop Each pass through the loop is numbered. 


Sets a starting and ending value for 
DO WHILE 


variable. 


Tests for true or false at top of loop. 
Repeats loop on true. On false, continues 
processing after END. 


imple Programs with REXX 


eS 


Tests for true or false at bottom of loop. 


Repeats loop on false. On true, continues 
processing after END. 


LEAVE Causes interpreter to exit a loop 


DO FOREVER Repeats instructions until the user says to 
quit. 


Use commands: HI or #cp ipl cms 


Parsing Words Assigns a different variable to each word in 
a group. 
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Writing Simple Programs with REXX 


Chapter 7. Using More Advanced Features 


As you become more skilled at programming, you will want to create 
programs that do more and run more efficiently. Sometimes this 
means adding a special function to your program or calling a 
subroutine. 


This chapter explains how these tools will help you build a better 
foundation in REXX. 
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Using Functions 
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In REXX, a function call can be written anywhere in an expression. 
The function performs the requested computation and returns a 
result. REXX then uses the result in the expression in place of the 
function call. 


Think of a function like this: You are trying to find someone’s 
telephone number (complete a function). You call the telephone 
operator and ask him to look up the number. He gives you a 
number, and you call the person. 


Generally, if the interpreter finds this in an expression: 


name (expression) 


it assumes that name is the name of a function and that this is a call 
to the function name(). There is no space between the end of the 
name and the left parenthesis. If you leave out the right parenthesis 
it is an error. 


The expressions inside the parentheses are the arguments. The 
argument can itself be an expression; the interpreter computes the 
value of this expression before passing it to the function. Ifa 
function requires more than one argument, use commas to separate 
each argument. 
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More than fifty functions are “built-in” to REXX. In this book, only a 
few will be introduced. You will find a dictionary of built-in functions 
in the VM/SP System Product Interpreter Reference. 


Let’s continue the discussion of functions by looking at the built-in 
function to obtain the greatest number of a set of numbers: 


MAX(number,number, ... ) 
For example: 


MAX(2,4,8,6) = 8 
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MAX(2,4+5,6) = 9 


Note that in the second example, the 4+5 is an expression. A 
function call, like any other expression, usually appears in a clause 
as part of an assignment or instruction. 


The DATATYPE() Function 


When attempting to do arithmetic on data entered from the keyboard, 
you can use the DATATYPE() function to check that data is valid. 


This function has several forms. The simplest form returns the word, 
NUM, if the argument (the expression inside the parenthesis) would 
be accepted by the interpreter as a number that could be used in 
arithmetical operations. Otherwise, returns the word, CHAR. For 
example: 


The value of DATATYPE(56) is NUM 
The value of DATATYPE(6.2) is NUM 
The value of DATATYPE($5.50) is CHAR 


This program asks the user to keep entering a valid number until he 
succeeds: 


/* Using the DATATYPE() Function */ 
do until datatype(howmuch) = 'NUM' 
say ‘Enter a number' 
pull howmuch 
1£ datatype(howmuch) = 'CHAR' 


then 

say 'That was not a number. Try again!' 
end 
say 'The number you entered was! howmuch 
exit 


Figure 33. DATATYPE EXEC, using a REXX built-in function 
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If you want the user to enter only whole numbers, you could use 
another form of the DATATYPE() function: 


DATATYPE (number ,whole) 
The arguments for this form are: 


1. number refers to the data to be tested. 


2. whole refers to the type of data to be tested. In this example, the 


data must be a whole number. 


This form returns a “1” if number is a whole number, ora “0” 
otherwise. 


The SUBSTR() Function 


The value of any REXX variable can be a string of characters. To 
select a part of a string, you can use the SUBSTR() function. 


SUBSTR is an abbreviation for substring. The first three arguments 


are: 
1. The string from which a part will be taken 


2. The position of the first character that is to appear in the result 
(characters are numbered 1, 2, 3...in the string) 


3. The length of the result. 


For example: 


S = 'reveal' 

Say substr(S,2,3) /* Says ‘eve’. Beginning with the second 
/* character, takes three characters. 

Say substr(S;3,;4) /* Says 'veal't. Beginning with the third 


/* character, takes four characters. 
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User-Written Functions 


You can also write your own functions in REXX. You can use 
functions written by others in your organization. As a new 
programmer, you should learn more about the built-in functions, 
before attempting to write your own. 


For more information, see user-written functions in the VM/SP 
System Product Interpreter User’s Guide. 
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A subroutine is a group of statements that can be called from more 
than one place in your main program. Subroutines can be in the 
same file as the main program, or they can be in a separate EXEC 
file. The advantage of using a subroutine is that you can reuse 
blocks of instructions in several places in a program. 
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The following diagram shows a subroutine that is included in the 
same EXEC file as the main program. 


CALL mysub 


Main Program 


EXIT 


MYSUB: 


Subroutine 


RETURN 
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The CALL instruction causes the interpreter to look through your 
program until it finds a label that marks the start of the subroutine. 
Remember, a label (word) is a symbol followed by a colon (:), as 
shown in the diagram above. Processing continues from there until 
the interpreter finds a RETURN or an EXIT instruction. 


A subroutine can be CALLed from more than one place ina 
program. When the subroutine ts finished, the interpreter always 
RETURNs to the instruction following the CALL instruction from 
which it came. 


Often each CALL instruction supplies data, called arguments, that 
the subroutine is to use. In the subroutine, you can find out what 
data has been supplied by using the ARG instruction. 


The CALL instruction appears in this form: 


CALL name (argumentl, argument2 ...) 


For the name, the interpreter looks for the corresponding label 
(name) in your program. If no label is found, the interpreter looks for 
a built-in function or an EXEC file of that name. 


The arguments are expressions. You can have up to ten arguments 
in a CALL instruction. An example of a program that calls a 
subroutine follows. Note that the EXIT instruction causes a return to 
CMS. It stops the main program from running on into the subroutine. 
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For example, this is your program: 


/* Calling a subroutine from a program */ 
do 2 
Gall triple "RR" 
Call. triple “nz” 
call triple "x" 
call triple "xX" 
say 
end 
say "R...! 
Say “Hew ad 
eres: 
i ree 


"REXX! 


/* This ends the main program. */ 


Subroutine starts here to repeat shout three times. 
The first argument is displayed on the screen three 
times, with punctuation. 


TRIPLE: 
say arg ( iar Varo Wargt 1. ri 
return /* Thais ends the subroutine. */ 


Figure 34. CHEER EXEC calls a subroutine from a main program 
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On the screen, the CHEER EXEC looks like this: 


Ready; 
cheer 
R, Ry R! 
E, EB, -Et 
=, (a 
<5 ‘Se 11 
Rj; R, R! 
E, E, «EI 
x £. 
Be xX, xX! 
KR, By 2 
Bis » By . Bf 
= 3a. 4 
So Re, 
Res ss 
Ben wil 
a ko 
Reh wt 
REXX! 
Ready; 
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To assign the arguments to variables (and make the program easier 
to read), you can use the PARSE ARG instruction or the PARSE 
UPPER ARG instruction. 


For example, if you have the following CALL instruction: 


CALL DINNER 'apple', 'coffee', 'steak', ‘'pie' 
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and you want the results of the four expressions in this instruction to 
be assigned to appetizer, drink, main_course, and dessert, you can 
write: 


PARSE ARG appetizer, drink, main_course, dessert 


The other form of the instruction, PARSE UPPER ARG, can be 
shortened to ARG. Use this instruction if you want the four 
arguments changed to uppercase. For example: 


ARG appetizer, drink, main_course, dessert 


Notice that, just as there are commas between the expressions in the 
CALL instruction, so there are commas between the symbols in the 
PARSE ARG or ARG instruction when used this way. 


The RETURN Instruction 


As previously noted, the RETURN instruction takes you back to the 
main part of the program. Processing continues with the instruction 
following the CALL. The form of the instruction is simply: 


RETURN 
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Issuing Commands from an EXEC 


REXX works in a number of environments (for example, CMS or 
XEDIT). To keep things simple, only CMS commands will be 
discussed in the examples. 


As discussed in “What’s in a REXX Program” on page 14, anything 


not recognized as an instruction, assignment, or a label, is 
considered a command. The statement recognized as a command is 
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treated as an expression. The expression is evaluated first, then the 
result is passed to CMS. 


The following example, COPYLIST EXEC, shows how a command is 
treated as an expression. Note how the special character (*) is put 
in quotes. 


/* Issuing a command from a program. This example copies 


/* all files that have a filetype of LIST from your ny 

/* A-Gisk to your B-disk. er A 

say 

copy '*' list a '= =' b j> SHAS. Sbavement 2s treated ac. */ 
/* an expression. a A 


/* The result 1s passed to CMS. */ 
exit 


Figure 35. COPYLIST EXEC copies files from your A-disk to your B-disk 


In the above example, if the asterisk (“) were not in quotes, the 
interpreter would attempt to multiply copy by list. 


Norking with Return Codes 


When you write commands in your programs, you should consider 
what would happen if the command failed to execute correctly. For 
example, a COPYFILE command might fail because the user’s disk 
was full. After this failure, you should at least EXIT from the 
program. 


Here’s how you discover such a failure. When commands have 
finished executing, they always provide a return code. A return code 
of zero nearly always means “all’s well.” Any other number usually 
means that something is wrong. You can see these codes on your 
screen when you issue commands from the CMS command line. 
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lf the command worked normally (the return code was 0), you will 
see the “Ready” message, like this: 


Ready; 


If the command did not work, you will see the “Ready” message with 
a return code, like this: 


Ready (00028) ; 


Any command that would be valid on the command line ts valid ina 
REXX program. The interpreter treats the command statement like 
any other expression, substituting the values of variables, and so on. 
(The rules are the same as for commands on the command line. For 
more information, see “The CMS Environment” in the VM/SP System 
Product Interpreter Reference.) 


When the interpreter has issued a command and CMS or CP has 
finished running it, the interpreter gets the return code and stores it 
in the REXX special variable RC. In your program, you should test 
this variable to see what happened when the command was 
executed. 


The following example shows a few lines from a program where the 
return code is tested: 


copyfile '*' list a '= =' b 
if ro =.) /* RC contains the return code from COPYFILE command */ 
then 
say 'All "* list" files copied' 
else 


Say ‘Error occurred copying files' 


Chapter 7 Using More Advanced Features 109 


Exercises 


You can find the answers to these exercises in the Appendix. 


ie 


Suppose someone wrote a function called HALF(). The function 
returns half of anumber. If a number is not even, the result 
returned is rounded high. 


What is the value of: 


a. HALF(100) 
b.HALF (100) 

c.HALF(19) 

d.HALF( HALF(26) + HALF(3+3) ) 


The RANDOM() function can be used for games and for statistical 
models. For example, to obtain a number, chosen at random 
from the range 1 through 6, you could write: 


random(1,6) 


Write a program called TOSS that will display either the word 
“Heads” or (just as likely) the word “Tails”. (Hint: The range is 
from 1 to 2). Run your program a number of times to See if the 
results are the same as if tossing a coin. 


This program prints a list of items ordered for an office. Write 
the subroutine ASTERISK to print a line of asterisks between 
each item. 
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ASTERISK EXEC: 


/* This EXEC calls a subroutine to print a line of asterisks */ 
call asterisk 

say ‘Item l Notebook' 
call asterisk 

say 'Item 2 Black Pens‘ 
call asterisk 

say 'Item 3 Calendar' 
call asterisk 

say 'Item 4 Staples' 
call asterisk 

exit 


Copy the program with your subroutine into an EXEC file and test 
the program. 


Summary 


You learned the following in this chapter: 


Perform a computation and returns a result. 98 | 


DATATYPE() Built-in function: verifies if the data is a 
specific type. 


SUBSTR() Built-in function: selects part of a string. 


sequenced group of statements that can be 


called from more than one place ina 
CALL 


program. 


Causes the program to look for a subroutine 
label and begin running the instructions 
following the label. 


Assigns arguments to variables. 
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es 


RETURN Ends a subroutine; causes the interpreter to 
go to the next line following the CALL. 


Issuing Commands Commands are treated like expressions. 


from An EXEC 


Return Codes Tells you if the command executed 
correctly. A zero return code means “all’s 
well.” 
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Chapter 8. Learning More About REXX 


You have just completed a basic introduction to REXX, but your 
education doesn’t have to stop here. In this chapter, you will see 
how to add to previously developed programs, and put ideas to work 
in brand-new programs. You'll find some suggestions for getting 
help, too. Just as you may continue special studies beyond 
graduation from school, your knowledge of REXX can grow even 
after you close the pages of this book. 
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Enhancing Your Programs 


The key to a successful program is that it can be used frequently. As 
your needs change, you may want to add more function to a 
program. Or, you may want to modify a program so it handles a 
different task. In the following examples, we will show you some 
ways to enhance two programs you wrote: the NOTEPAD EXEC and 
CALC EXEC. 


Modifying the NOTEPAD Program 
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The NOTEPAD program can be modified several ways. Fora simple 
change, you can have the program tell what day it is when the 
reminders are listed. To do this, you can use the DATE() function. 
The original program contained these lines: 


say ‘Things to do today:' 
type notepad script 
exit 


Adding the date requires a new assignment of a variable with the 
DATE() function, and the modification of the SAY instruction. The 
DATE() function has these options: 


Basedate 
Century 
Days 
European 
Julian-OS 
Month 
Ordered 
Sorted 
USA 
Weekday. 
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For more information on the options, see the VM/SP System Product 
Interpreter Reference. 


You can assign the variable today a weekday like this: 


today = date(weekday) 


Remember, to indicate a REXX function, there should be no space 
between the name of the function (DATE) and the left parenthesis. 
The SAY instruction also needs to be changed so that today is 
treated as a variable. 


say 'Things to do' today 


The last line of the program remains the same: 


"type notepad script' 


The new program is: 


/* A reminder of things to do */ 
today = date(weekday) /* Assigns a weekday */ 


say 'Things to do' today 
type notepad script 
exit 


Figure 36. NEWNOTE EXEC, modifying a program 


When Mike tried the new program, it looked like this: 


Ready; 
newnote 
Things to do Wednesday 


1. Answer mail. 
ae Call. George about Crips 
3. Order book. 


Ready; 
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Modifying the CALC Program 


Let’s look at two changes you can make to the CALC program. The 
first change allows you to enter a character or the symbol for an 
arithmetic operator. The original program contained these lines: 


/* This program is your desk calculator. ¥*/ 
say 'This program acts as a desk calculator.' 
say ‘Enter calculations in the form of:' 

say 'number operation number' 


say 'where operation is the symbol: + - * /' 
say 'for ADD, SUBTRACT, MULTIPLY, or DIVIDE' 
say 


do forever 
say 'Enter your calculation (or press ENTER to quit)' 
pull numl op num2 /* Gets numbers and operator ae 
if numl = ''' /* If user presses ENTER key or space */ 
then /* program ends. a 
leave 
select 
when op = '+'! 
then 
say numl op num2 '‘'is 
when op = '-! 
then 
say numl op num2 ‘is 
when op = ‘*! 
then 
say numl op num2 
when op = !/' 
then 
say numl op num2 'is' numl / num2 
otherwise 
say numl op num2 ‘is not a valid calculation, Try again!’ 
end 
end 
exit 


numl + num2 


numl - num2 


numl * num?2 


You can add this SAY instruction to the program: 


say ‘or enter the first character: A, S, M, D.' 
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To make this change work, you also have to modify the SELECT 
instruction as follows: 


select 
when op='A' 
then say 
when op='S' 
then say 
when op='M' 
then say 
when op=!D'! 
then say 
otherwise 
say numl 
end 


The second change lets you check the input from the user to see if 
numbers are entered for the variables num1 and num2. To do this, 


| op= "+! 


numl '+' num2 
' | 


| Op= = 
numl ‘'-' num2 
[Ops oe: 
Wim tayo 
| Op." 7 
numl '/' num2 


numl + num2 
numl - num2 
num’) * mamZ 


numl / num2 


op num2 ‘is not a valid calculation, try again!' 


you can use the DATATYPE() function with the IF instruction, as 


shown: 


if datatype(num1) 
then say numl op 


a= 'NUM' | datatype(num2) n= 'NUM' 
num2 ‘is not a valid calculation, 
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With the changes added to the CALC EXEC the new program is: 


f/* This program 1S yout desk calculator. */ 

say 'This program acts as a desk calculator. 

say 

say ‘Enter calculations in the form of:' 

say 

say ' number operation number' 

say 

say ‘where operation is the symbol: + - * /' 

say ‘for ADD, SUBTRACT, MULTIPLY, or DIVIDE' 

say 

say ‘or enter the first character: A, S, M, D.' 

say 

say 

do forever 
say 'Enter your calculation (or press ENTER to quit)' 
pull numl op nmumZ 


if numl = '' then leave 
ae A 
/* Checking that numbers were entered ad 
7° mf 
if datatype(numl) a= 'NUM' | datatype(num2) “a= 'NUM' 
then say numl op num2 '1is not a valid calculation, try again!' 
else 
select 
when op='A!' | op= '+t! 
then say numl '+' num2 'is' numl + num2 
when op='S' | op= '-' 
then say numl '-' num2 'is' numl - num2 
when op='M' | op= '*! 
then say numl '*' num2 ‘'is' numl * num2 
when op='D! | op= '/'! 
then say numl ‘'/' num2 ‘'is' numl / num2 
otherwise 


say numl op num2 'is not a valid calculation, try again!' 


Figure 37. NEWCALC EXEC, enhancing the calculator program 
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When Mike tried the new program, it looked like this: 


Ready; 
newcalc 
This program acts as a desk calculator. 


Enter calculations in the form of: 
number operation number 


where operation is the symbol: + - * / 
for ADD, SUBTRACT, MULTIPLY, or DIVIDE 


or enter the first character: A, S, M, D. 


Enter your calculation (or press ENTER to quit) 
4. sa «5 

7 #5 a6 de 

Enter your calculation (or press ENTER to quit) 
30° 7 3 

30 / 3 is 10 

Enter your calculation (or press ENTER to quit) 
lo m 4 

16 * 4 is 64 

Enter your calculation (or press ENTER to quit) 


Re 


Designing New Programs 


As you progressed through this book, you may have thought of other 
programs you would like to write. Experienced programmers use 
several techniques to develop a program, such as flowcharts and 
block diagrams. Remember, though, that as a beginning 
programmer, you can design simple REXX programs by following 
these steps: 


1. Identify the problem to solve, and translate it into a step-by-step 
procedure. 
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2. Write REXX instructions to solve each step. 
3. Test the program to see if the results meet the requirements. 
4. Revise the program to correct errors. 


sometimes a simple problem requires many instructions to solve it. 
A program with many instructions is not necessarily more difficult 
than one with few instructions. The simple program may require 
more instructions because steps cannot be combined. A more 
difficult program may use built-in functions or subroutines to handle 
complex steps easily. 
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The following program provides a solution to the question, “How can 
| check what time it is through my computer?” It contains some 
familiar instructions and functions, as well as two or three new 
items. Although this program may look complicated, you have 
already learned many of the steps in this book. Putting the 
instructions together just requires some practice. You may want to 
try this program and keep it for your everyday use. 
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This is the QTIME EXEC: 


Dis! ——— eS ee ee Se ee eS a i a i a i a ee ee 
f* OVIME EXEC 
| hati 
ft Displays the current time in words and numbers. 
Fa ee ee ee ee ee ee ee 
fp Assign words to compound variables. 
near .0='' j*® Exactly. 
near.1='till' f* Till. the hour. 
near.2='after' /* After the hour. 
now=time() /* Get the current system time 
, Ail 
/*Split the hours, minutes, and seconds into separate variables. 
f* 
parse var now hour':'min': 
i 
tah Tf seconds are 30 or more, round up to the next minute. 
Fa 
if sec > 29 
then min=mintl 
7° 
Y ei Adjust the hour and minutes if we are past the half hour. 
Ves 
select 
when min > 30 then /* If we are past the half 
do /* hour, set the hour 
hour=hourtl /* variable to the next hour, 
min=60-min /* subtract current minutes 
/* from 60 to get minutes 
fe “TTL” the next hour. 
if min=0 /* If minutes turn out to be 
then mod=0 /* O, then it is on the hour 
/* (not exactly, but close 
7* enough). If minutes are 
else mod=1 /* not O, then prepare to 
end /* select the "till" compound 
/* variable. 
when min > O then mod=2 /* If we are not past the 
7/* half nour, but not exactly 
/* on The hour, it*s “after” 


Figure 38 (Part 1 of 3). QTIME EXEC displays the time 
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otherwise 
mod=0 /* Otherwise, it's exactly on 
end /* the hour. 
if min7=00 /* If the minutes are not x 
then min=strip(min,'L',O) /* zero, remove leading zeros 
/* (if any) from the minutes. 
/* Strip 1s @ built-in 
f*® Diner ion ~ 
f* Check for special case of noon or midnight. 
* 
if hour//12=0 & min=00 f* Check if it's noon: ox 
then /* midnight. 
do /* If so, which one? 
if hour=12 fe AP the hour equals 12, 
then 
say 'It''s 12 Noon.' J*® TC's noon: 
else 
say ‘'It''s 12 Midnight.' /* Otherwise, it's midnight. 
exit /* We are finished now. 
end 
else j* Ge MOG. NOCH: Or Mani ghee, 
nop /* continue processing. 
ro 
/* Otherwise, start building the appropriate response string. 
a) 
select 


when min=l then minute='minute' /* One minute after or till. 
when min>1l then minute='minutes'/* More than one minute. 


when min=00 then /* Zero minutes, we need not 
do /* display the minutes. 
minute='! /* Make the min and minute 
min='' /* variables null so they do 
end f* NOL. Gdispkay. 
otherwise 
nop 
end 


Figure 38 (Part 2 of 3). QTIME EXEC displays the time 
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out='It''s' min minute near.mod /* Compound variable, variable*/ 


/* used as special character. 
/* Build the output string as 
/* it stands so far. 

if hour > 12 


then hour = hour - 12 f*® GeL tad Of z24=hour clock 
else if hour=0 
then hour = 12 /* ...and allow for midnight 
hour = strip(hour,'L',0O) /* Remove any leading zeros 
/* from the hour, if any. 
out=out hour /* Attach the hour to the 
f* OOEPUL. SUring: 
if min='' 
then out=out ‘'o!''clock' /* AGG o'clock if exactly on 
/* the hour. 
out=space(out,1) /* Make sure there is only 
/* one space between each 
f® word. 
/* Space is a built-in 
7 TCE ON. 
say out'.' /* Display the final result. 
exit /* Now we're done. 


Figure 38 (Part 3 of 3). QTIME EXEC displays the time 
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Finding More Information 


When learning something new, most of us make mistakes or have a 


problem now and then. Sometimes it is difficult to ask for help. If 
you have trouble with REXX programming, see if you can talk to 
someone about it. Sources to consider are: 


e Your system administrator 


e A programmer working in your organization 
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peas) 


e An instructor in the computer science department at a local high 
school or college. 


eo aN a SR ae 6 A ee 2 rT OOS | PES OTS ee a A | 
Conclusion 


O4 


We hope this book took the mystery out of computer programming in 
REXX for you. You may have already thought of new ways REXX can 
help you with your tasks. If you tried the exercises in the book, and 
wrote a program, you can be pleased with your accomplishment. 
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Appendix. Answers to Exercises 


Pad TESTS Hee BR eS Rte es ea rey Ee SE Se re te, 
Chapter 3 Answers 


1. The syntax of the MADAM EXEC is: 
/* Polite inquiry */ This is a comment. 


Jane = "Mrs. Doe" This is an assignment. The variable Jane 
gets the value of Mrs. Doe. 


say This is an instruction. The rest of the line is 
interpreted and the result is displayed. 


How This is a string. 


is This is changed to uppercase because it is 
not in quotes. 


jane This is the name of a variable. The value of 
Mrs. Doe is substituted. 


? This is the name of a variable. 


Here’s what appears on the screen: 


madam 
How IS Mrs. Doe ? 
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2. There is a syntax error in the TROUBLE EXEC. It was caused by 
line 2, which contained an unexpected comma. To correct the 
program, remove the comma or add quotes around the comma. 


[eis 2. STi? 2° Soest hs a ere he sat a PR ee a, a et ey Re ee ee ee Fee 
Chapter 4 Answers 


1. REXX variables are: 


a. Yes 

b. Yes 

c. Yes. It’s the same as OLD WORLD. 

d. No, because the first character is a number. 
e. Yes 


2. The ASSIGN EXEC is missing the assignment of a value to the 
variable “input.” We assigned input a value of 10 as follows: 


/* This program has something missing! #*/ 
input = 10 


say input 
exit 


3. The FAMILY program displays: 


There are 5 people in this family 
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Chapter 5 Answers 


1. For MEASURES EXEC, this is displayed when the program is run: 


Measures 
A 


O 
Ready; 


2. The values of the expressions are “1” (true). 


| aia Aaa ater SE a et eet nO a en Ea | a 
Chapter 6 Answers 


e Asimple solution to say the days of the week repeatedly is: 


DAYS EXEC: 


/* This program says days of the week indefinitely */ 
do forever 

say "Sunday" 

say "Monday" 

say "Tuesday" 


say "Wednesday" 
say "Thursday" 
say "Friday" 
say "Saturday" 
end 

exit 
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eg ah De 1 is eee ST as Pe oe oe et ees tet eT, 
Chapter 7 Answers 


1. The values using the HALF() function are: 


a. 50 

b. HALF 100. This is not a function because there is a space 
between the HALF and the left parenthesis. 

c. 10. The result (9) gets the remainder (1). 

d. 8. 


2. A simple solution for the TOSS EXEC, using the RANDOM() 
function, is: 


/* THis: program Simulacves Lossing 4a. coin *7 
if random(1,2) = 1 
Chen 


say "Heads" 
else 

say "Tails" 
exit 
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3. A possible solution for the ASTERISK subroutine is: 


/* This EXEC calls a subroutine to print a line of asterisk */ 
call asterisk 

say 'Item 1 Notebook' 

call asterisk 

say ‘Item 2 Black Pens'! 

call asterisk 

say ‘Item 3 Calendar' 


call asterisk 

say 'Item 4 Staples' 

call asterisk 

exit 

asterisk: 

/* This prints a line of asterisk */ 
say PRKKEKKKKKKKKKEKKEKKEKKKEKKKAEKKKKK ! 


return 
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Glossary 


argument. Ina function, the expression inside 
the parenthesis. 


assignment. Putting a string in a special 
place in the computer’s memory. 


command. A command is a word, phrase or 
abbreviation that tells the system to do 
something. In REXX, anything that is not 
identified as a REXX instruction, assignment, 
or label is considered a command. 


comment. Ina REXX program, words that tell 
what a program is for, what kind of input it can 
handle, and what kind of output it produces. 


decimal fraction. A number with a decimal 
point (for example, 1.5) 


function call. A procedure that performs a 
requested computation and returns a result. 


instruction. Tells the REXX interpreter to do 
something. 


label. A name followed by a colon. Used with 
subroutines. 


loop. A group of instructions that can be 
executed more than once. Asimple 
repetitive loop can be executed a fixed 
number of times. A conditional loop is 
executed when a true or false condition is met. 


program. A list of instructions to a computer. 


string. In aREXX program, a group of 
characters inside single or double quotes. 


subroutine. A sequenced group of statements 
that can be called from more than one place in 


a main program. 


syntax. The way in which words are put 
together to form phrases or sentences. 


value. What a variable is assigned. 
variable. A particular piece of data, used by a 
program in a particular way, but whose value 


may vary. 


whole number. A number with a zero (or no) 
decimal part. 
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index 


answers to exercises 125 
apostrophe 13 
ARG instruction 106 


arguments 

of a CALL instruction 104 
arithmetic 

addition 43 

division 44 


multiplication 43 

operations 42 

operators 46, 116 

subtraction 43 
assignments 

definition of 18 

of variables 39,115 


blank lines 22 


character priority wnen comparing 66 
characters in variable names 38 
CMS commands 20 
comma 14 
commands 
CMS 20 


COPYFILE 108 
definition of 20 
tostopaloop 85 
to stop aprogram 84 
TYPE 29 
used in REXX 20 
XEDIT 9 
comments 
adding 51 
blocks 51 
definition of 12 
placement 6, 13 
required 12 
symbols for 12 
comparisons 
characters 65 
numeric 65 
operators 65 
using 67 
CONFIRM END panel in VM/IS_ 5 
COPYFILE command 108 


DATATYPE function 100 
DATE function 114 
decimal fractions 42 
decisions 

instructions for 56 
definitions 131 
DO FOREVER instruction 83 
DO instruction 58 
DO UNTIL instruction 80 
DO WHILE instruction 78 
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[E 


ELSE keyword 59 
END keyword _ 58, 61 
equal 
as acomparison 6/7 
as anassignment 67 


errors 
fixing 32 
EXECS 
ADD 50 
AND 69 
CALC 90 
CHEER 105 


CHITCHAT 17 
COMMAND 20 
COPYLIST 108 
DATATYPE 100 
definition of 6 
DOUNTIL 81 
DOWHILE 79 
ERROR 34 
FOREVER 83 
HELLO 6 
HELLO with mixed case 21 
LEAVE 82 
LIKEME 60 
LOOP 75 
MATH 45 
NAME 16 
NEWCALC 118 
NEWLOOP 76 
NEWNOTE 115 
NOTEPAD © 31 
NOTERR- 33 
OR 70 

QTIME 121 
QUOTES 21, 22 
RAH 14 
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SECRET 85 
SELECT 63 


SELECT with NOP 64 


TF 67 

VARIABLE 41 

VAROOPS 41 
EXIT instruction 6, 17 
expressions 

evaluating 46 

in parentheses 47 


file 


creating 30 
naming 9 


finding more information 


flowcharts and block diagrams 


function call 98 
functions 
built-in 99 
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DATATYPE 46, 100, 117 


DATE 114 
definition of 98 
MAX 99 
SUBSTR_ 101 
user-written 102 
using 98 


[¢ | 


getting started 
using REXX 5 
grouping instructions 


58 


119 


LM 


HI (Halt Interpretation) command 84 


[i] 


IF instruction 6, 57 
indentation 57 
instructions 
ARG 106 
CALL 104 
definition of 15 
DO 59 
DO FOREVER 83 
DO UNTIL 80 
DO WHILE 78 
EXIT 17 
grouping 58 
IF “67 
indentation in 57 
LEAVE 82 
NOP (No Operation) 64 
PARSE PULL 17 
PARSE UPPER ARG 107 
processing 56 
PULL 16 
RETURN 107 
SAY 15 
SELECT 61, 117 
interpreter 12 


K 


keywords 
ELSE 59 
OTHERWISE 61 
THEN 57 
WHEN 61 
labels 


definition of 19 
in subroutine 19 
LEAVE instruction 82 
logical operators 
AND 68 
NOT 68 
OR 69 
loops 
beginning and ending 74 
conditional 78 
DO FOREVER instruction 83 
DO|=1to10 76 
DO UNTIL instruction 80 
DO WHILE instruction 78 
DO-END 75 
ending 82 
halting endless loops 85 
LEAVE instruction 82 
repetitive 74,75 
using 74 
lowercase 17 
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InVM/IS 5 
| | program 
14 


comma and semicolon in 
comments in 12 


matching quotes 13 creating 48, 86 

MAX function 99 definition of 4 

mixed case 20 designing new programs’ 119 
enhancing 114 
fixing 32 
modifying CALC 116 

| modifying NOTEPAD 114 

parts of 14 

NOP instruction 64 FUNG: Spee Oi 
sample 6 


steps to writing 28, 119 


writing 48, 87 
| o| programming 


flowcharts and block diagrams 119 
languages 4 


operators PULL instruction 6, 16 
arithmetic 116 


comparing 65 


logical AND 68 
logical NOT 68 | @| 
logicalOR 69 
true and false 65 
OTHERWISE keyword 61 quotes 


for spacing 21 
single and double 13 


fr) using 15 


parentheses 4/7 | R| 
PARSE PULL instruction 16 
PARSE UPPER ARG instruction 106 
parsing RETURN instruction 107 
words’ 85 REXX (Restructured Extended Executor) 


password and userid 5 fanguage 
PRIMARY MENU in VM/IS. 5 definition 4 


Productivity Facility 
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SAY instruction 6, 15, 114 
SELECT instruction 61, 117 
semicolon 14 
spacing 
between lines 22 
between words 21 
entering a blank space 9 
strings 
definition of 13 
subroutines 
definition of 102 
label in 19 
used with EXIT 17 
SUBSTR function 101 
syntax 32 
system administrator 5, 123 
System Product Editor (XEDIT) 
command 9 
System Product Interpreter 
for REXX language 4, 11 


THEN keyword _ 58, 61 
true and false operators 65 
TYPE command 20, 29 


[| 


uppercase 16,17 
user-written functions 102 
userid and password 5 


value of variables 39 
variables 
assigning values 39 
assigning with PULL 39 
definition of 38 
initial value 40 
rules fornaming 38 
unintentionally assigning 41 
VM/Integrated System (VM/IS) 
EXEC languages in 12 
getting outof 5 


Ei 


WHEN keyword 61 
whole numbers 42 
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XEDIT (System Product Editor) 9 
XEDIT command 9 
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